Sign in

v2

latestOpenAPI 3.1.02026-07-312303692.4 MB
Connector

Upsert Connector

Create or update a connector.

put/api/v1/connector/{connector_id}

Path parameters

connector_idstring required

The Connector's ID or UID.

Example:unique-identifier

The Connector's ID or UID.

Request body

namestring
logostring uri nullable
descriptionstring
kind'Custom' | 'AgenticCommerceProtocol' | 'CloseCRM' | 'CustomerIO' | 'Discord' | 'Hubspot' | 'Inngest' | 'Loops' | 'Otel' | 'Resend' | 'Salesforce' | 'Segment' | 'Sendgrid' | 'Slack' | 'Teams' | 'TriggerDev' | 'Windmill' | 'Zapier'
instructionsstring
allowedEventTypesstring[] nullable
transformationstring required
featureFlagsstring[] nullable

Example request

{
  "name": "My first connector",
  "logo": "https://example.com/logo.png",
  "description": "Example connector description",
  "instructions": "Markdown-formatted instructions",
  "allowedEventTypes": [
    "user.signup",
    "user.deleted"
  ],
  "transformation": "function handler(webhook) { /* ... */ }",
  "featureFlags": [
    "cool-new-feature"
  ]
}

Response

idstring required

The Connector's ID.

orgIdstring required

The Environment's ID.

uidstring nullable

The Connector's UID.

kind'Custom' | 'AgenticCommerceProtocol' | 'CloseCRM' | 'CustomerIO' | 'Discord' | 'Hubspot' | 'Inngest' | 'Loops' | 'Otel' | 'Resend' | 'Salesforce' | 'Segment' | 'Sendgrid' | 'Slack' | 'Teams' | 'TriggerDev' | 'Windmill' | 'Zapier' required
namestring required
logostring uri nullable
descriptionstring required
instructionsstring required
allowedEventTypesstring[] nullable
transformationstring required
createdAtstring date-time required
updatedAtstring date-time required
transformationUpdatedAtstring date-time required
featureFlagsstring[] nullable
productType'Dispatch' | 'Stream' required

Example response

{
  "id": "trtmpl_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "orgId": "org_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "uid": "unique-identifier",
  "allowedEventTypes": [
    "user.signup",
    "user.deleted"
  ],
  "featureFlags": [
    "cool-new-feature"
  ]
}