---
title: "Create Ingest Source"
method: POST
path: "/ingest/api/v1/source"
tags: ["Ingest Source"]
---

# Create Ingest Source

`POST /ingest/api/v1/source`

Create Ingest Source.

## Headers

- `idempotency-key` string

## Request body

- union
  - object — Webhooks with no verification scheme or special handling.
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'generic-webhook', required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'cron', required
    - `config` CronConfig, required
      - `schedule` string, required
      - `payload` string, required
      - `contentType` string, nullable — Override the default content-type. Recommended if the payload is not JSON.
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'adobe-sign', required
    - `config` AdobeSignConfig, required
      - `clientId` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'beehiiv', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'brex', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'checkbook', required
    - `config` CheckbookConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'clerk', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'docusign', required
    - `config` DocusignConfig, required
      - `secret` string, nullable
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'easypost', required
    - `config` EasypostConfig, required
      - `secret` string, nullable
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'github', required
    - `config` GithubConfig, required
      - `secret` string, nullable
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'guesty', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'hubspot', required
    - `config` HubspotConfig, required
      - `secret` string, nullable
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'incident-io', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'lithic', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'meta', required
    - `config` MetaConfig, required
      - `secret` string, required
      - `verifyToken` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'nango', required
    - `config` NangoConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'nash', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'openclaw', required
    - `config` OpenClawConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'orum-io', required
    - `config` OrumIoConfig, required
      - `publicKey` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'panda-doc', required
    - `config` PandaDocConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'port-io', required
    - `config` PortIoConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'pleo', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'psi-fi', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'replicate', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'resend', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'rutter', required
    - `config` RutterConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'safebase', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'sardine', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'segment', required
    - `config` SegmentConfig, required
      - `secret` string, nullable
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'shopify', required
    - `config` ShopifyConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'slack', required
    - `config` SlackConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'stripe', required
    - `config` StripeConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'stych', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'svix', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'zoom', required
    - `config` ZoomConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'tailscale', required
    - `config` TailscaleConfig, required
      - `secret` string, required — Shared secret for Tailscale Webhooks
      - `timestampGraceSeconds` integer, nullable — Grace period (in seconds) for the timestamp. If not passed, timestamp age will not be checked.
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'telnyx', required
    - `config` TelnyxConfig, required
      - `publicKey` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'vapi', required
    - `config` VapiConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'open-ai', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'render', required
    - `config` SvixConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'veriff', required
    - `config` VeriffConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'airwallex', required
    - `config` AirwallexConfig, required
      - `secret` string, required
  - object
    - `name` string, required
    - `uid` string, nullable — The Source's UID.
    - `metadata` object
    - `type` 'vgs', required
    - `config` VgsConfig, required
      - `secret` string, required

## Response `201`

- union
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'generic-webhook', required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'cron', required
    - `config` CronConfig, required
      - `schedule` string, required
      - `payload` string, required
      - `contentType` string, nullable — Override the default content-type. Recommended if the payload is not JSON.
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'adobe-sign', required
    - `config` AdobeSignConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'beehiiv', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'brex', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'checkbook', required
    - `config` CheckbookConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'clerk', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'docusign', required
    - `config` DocusignConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'easypost', required
    - `config` EasypostConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'github', required
    - `config` GithubConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'guesty', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'hubspot', required
    - `config` HubspotConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'incident-io', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'lithic', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'meta', required
    - `config` MetaConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'nango', required
    - `config` NangoConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'nash', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'openclaw', required
    - `config` OpenClawConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'orum-io', required
    - `config` OrumIoConfigOut, required
      - `publicKey` string, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'panda-doc', required
    - `config` PandaDocConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'port-io', required
    - `config` PortIoConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'psi-fi', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'pleo', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'replicate', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'resend', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'rutter', required
    - `config` RutterConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'safebase', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'sardine', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'segment', required
    - `config` SegmentConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'shopify', required
    - `config` ShopifyConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'slack', required
    - `config` SlackConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'stripe', required
    - `config` StripeConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'stych', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'svix', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'zoom', required
    - `config` ZoomConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'tailscale', required
    - `config` TailscaleConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'telnyx', required
    - `config` TelnyxConfigOut, required
      - `publicKey` string, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'vapi', required
    - `config` VapiConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'open-ai', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'render', required
    - `config` SvixConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'veriff', required
    - `config` VeriffConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'airwallex', required
    - `config` AirwallexConfigOut, required
  - object
    - `id` string, required — The Source's ID.
    - `uid` string, nullable — The Source's UID.
    - `name` string, required
    - `ingestUrl` string, uri, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` object, required
    - `type` 'vgs', required
    - `config` VgsConfigOut, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.net/svix/apis/svix-api.md) · [All operations](https://skmtc.net/svix/apis/svix-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/svix/svix-api/versions/16dbcc056c48/schema)