Skip to main content
POST
Create a project

Authorizations

hookie_session
string
cookie
required

The console's sealed session cookie, set by WorkOS AuthKit. Mutating requests also require the X-Requested-With CSRF header.

Headers

Idempotency-Key
string

Makes a POST safe to retry for 24 hours: the same key, credential, path and body returns the stored response (Idempotent-Replayed: true) instead of running again. 422 if the key was used for a different request; 409 while the first is in flight.

Required string length: 1 - 255

Body

application/json
name
string
required

Trimmed; must be non-empty and at most 80 characters.

Required string length: 1 - 80
type
enum<string>
required

A webhook project is seeded with one enabled webhook so it has a URL immediately.

Available options:
webhook,
ai_trigger

Response

Created. Note the status is 200, not 201. The slug is generated from the name plus a random salt. For a webhook project the seeded endpoint is returned; its slug is the high-entropy public URL secret.

project
object
required
webhook
object

Present only for type=webhook.