# Flowg8 · Create integration

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

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.

## POST /v1/integrations

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Administrator or Sandbox developer required. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Input parameters
- name (string, required): min length 1 · max length 80
- kind (string, required): email | teams | http | email_inbound
- active (boolean, optional): default true
- config (object, required): 

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flowg8.io/v1/integrations" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001" \
  -H "idempotency-key: example-create-integration-001" \
  -H "content-type: application/json" \
  --data-raw '{
  "name": "Purchasing HTTP",
  "kind": "http",
  "active": true,
  "config": {
    "url": "https://example.com/flow-events"
  }
}'
```

Source: /docs/create-integration
Full schemas: /docs/openapi.json