Organization

Create integration

Create a named outbound connection. Email triggers are managed through flow drafts.

POST/v1/integrations

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

kind=email requires config.recipientDomains. teams requires a Microsoft Teams Workflows HTTPS URL; http accepts HTTPS and optional authorization. Creating email_inbound separately returns EMAIL_TRIGGER_DESIGNER_REQUIRED. Create or save a flow draft with start.trigger={kind:email,integrationId:null}; an address is allocated atomically, after verifying an organization sender domain with TXT. No customer gateway secret is needed.

Request body

namestringrequiredmin length 1 · max length 80

kindstringrequiredemail | teams | http | email_inbound

activebooleanoptionaldefault true

configobjectrequired

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Organization

Create integration

Create a named outbound connection. Email triggers are managed through flow drafts.

POST/v1/integrations

Administrator or Sandbox developer requiredUser token only. Integration keys cannot authorize this operation.

How it works

Request body

namestringrequiredmin length 1 · max length 80

kindstringrequiredemail | teams | http | email_inbound

activebooleanoptionaldefault true

configobjectrequired

Required fields & full validation schema → OpenAPI

Request essentials

Authorization: Bearer $FLOWG8_ACCESS_TOKEN
X-Organization-Id: Your workspace UUID
Idempotency-Key: Stable per operation; 8–128 characters

Have an implementation question?Ask about this endpoint. Answers include source references.

Create integration

How it works

Request body

Request essentials

Ask the docs

Create integration

How it works

Request body

Request essentials

Ask the docs