---
title: "ezgh workflows apps create"
description: "Create an app; a push app's signing secret is shown once."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh workflows apps create

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh workflows apps create <name> --kind push --endpoint <url> | --kind pull [--queue q] [--partitions n] [flags]
```

Create an app in the project.

A push app (`--kind` push, the default) is an HTTPS endpoint on port 443 that Workflows calls, signing every request. Its signing secret is printed once, alone on stdout, and can't be shown again; give it to your app, then sync it (`ezgh workflows apps sync`) so Workflows learns its workflows. `--endpoint` takes effect at that first sync.

A pull app (`--kind` pull) has no endpoint or signing secret: its workers poll a task queue (`--queue`, "default" unless given; it can't change) spread over `--partitions` (4 unless given, 1 to 32; it can grow later, never shrink), and announce their workflows when they poll.

Part of [`ezgh workflows apps`](/cli/reference/workflows-apps).

## Examples

```sh
EZGH_WORKFLOWS_SIGNING_SECRET=$(ezgh workflows apps create web --endpoint https://example.com/api/workflows)
ezgh workflows apps create workers --kind pull --queue emails --partitions 8
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--endpoint` | string |  | a push app's https URL |
| `--kind` | string | `push` | push (an HTTPS endpoint) or pull (workers poll a queue) |
| `--partitions` | int64 | `4` | a pull app's partition count, 1 to 32 |
| `--queue` | string |  | a pull app's task queue (default "default") |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/workflows-apps-create/index.mdx