---
title: "Create an integration"
method: POST
path: "/integrations"
tags: ["Integrations"]
---

# Create an integration

`POST /integrations`

## Request body

- object
  - `label` string — Label of the integration
  - `configs` union — Decrypted Key/Value object of the associated configuration for that provider
    - object
      - `webhook_secret_key` string, required
      - `algorithm` 'md5' | 'sha1' | 'sha256' | 'sha512', required
      - `header_key` string, required
      - `encoding` 'base64' | 'hex', required
    - object
      - `header_key` string, required
      - `api_key` string, required
    - object
      - `api_key` string, required
    - object
      - `webhook_secret_key` string, required
    - object
      - `username` string, required
      - `password` string, required
    - object
      - `webhook_secret_key` string, required
    - object
      - `webhook_secret_key` string, nullable
      - `vercel_log_drains_secret` string, required
    - object
  - `provider` 'AIPRISE' | 'AIRCALL' | 'ALCHEMY' | 'ATTENTIVE' | 'DOCUSIGN' | 'INTERCOM' | 'HMAC' | 'BASIC_AUTH' | 'API_KEY' | 'MANAGED' | 'HOOKDECK_OUTPOST' | 'SANITY' | 'BIGCOMMERCE' | 'CLAUDE' | 'OPENAI' | 'POLAR' | 'BRIDGE_XYZ' | 'BRIDGE_API' | 'CHARGEBEE_BILLING' | 'CHAINDOTS' | 'CLOUDSIGNAL' | 'COINBASE' | 'COURIER' | 'CURSOR' | 'MERAKI' | 'FIREBLOCKS' | 'FRONTAPP' | 'ZOOM' | 'TWITTER' | 'RECHARGE' | 'CRONOFY' | 'RECURLY' | 'RETELL' | 'REVOLUT' | 'RING_CENTRAL' | 'STRIPE' | 'CLOUDINARY' | 'PROPERTY-FINDER' | 'QUOTER' | 'SHOPIFY' | 'TWILIO' | 'GITHUB' | 'POSTMARK' | 'TALLY' | 'TYPEFORM' | 'PICQER' | 'XERO' | 'SVIX' | 'RESEND' | 'GEMINI' | 'ADYEN' | 'AKENEO' | 'GITLAB' | 'WOOCOMMERCE' | 'OKTA' | 'OURA' | 'COMMERCELAYER' | 'COMMUNITY' | 'HUBSPOT' | 'MAILERSEND' | 'MAILGUN' | 'PERSONA' | 'PIPEDRIVE' | 'SENDGRID' | 'WORKOS' | 'SYNCTERA' | 'AWS_SNS' | 'THREE_D_EYE' | 'TWITCH' | 'ELEVENLABS' | 'ENODE' | 'FAUNDIT' | 'FAVRO' | 'LINEAR' | 'SHIPBOB' | 'SHIPHERO' | 'SHOPLINE' | 'WIX' | 'NMI' | 'NEON' | 'ORB' | 'PYLON' | 'RAZORPAY' | 'REPAY' | 'SQUARE' | 'SOLIDGATE' | 'TRELLO' | 'EBAY' | 'TELNYX' | 'DISCORD' | 'TOKENIO' | 'FISERV' | 'FUSIONAUTH' | 'BONDSMITH' | 'VERCEL_LOG_DRAINS' | 'VERCEL' | 'TEBEX' | 'SLACK' | 'SMARTCAR' | 'MAILCHIMP' | 'NUVEMSHOP' | 'PADDLE' | 'PAYPAL' | 'PAYMOB' | 'PAYSTACK' | 'SCRAPFLY' | 'PORTAL' | 'TREEZOR' | 'PRAXIS' | 'CUSTOMERIO' | 'EXACT_ONLINE' | 'FACEBOOK' | 'WHATSAPP' | 'REPLICATE' | 'TIKTOK' | 'TIKTOK_SHOP' | 'AIRWALLEX' | 'ASCEND' | 'ALIPAY' | 'ZENDESK' | 'UPOLLO' | 'SMILE' | 'NYLAS' | 'CLIO' | 'GOCARDLESS' | 'GOOGLE_PUBSUB' | 'LINKEDIN' | 'LITHIC' | 'UTILA' | 'GREENDOT' | 'ZEROHASH' | 'AIRTABLE' | 'ASANA' | 'ASHBY' | 'FASTSPRING' | 'PAYPRO_GLOBAL' | 'USPS' | 'WALMART' | 'FIREFLIES' | 'FLEXPORT' | 'UBER' | 'WECHAT' | 'BUNNY_STREAM' | 'SHIPSTATION' | 'CIRCLE' | 'STATSIG' | 'VAPI' | 'VOLUME'
  - `features` IntegrationFeature[] — List of features to enable (see features list above)

## Response `200`

A single integration

- Integration
  - `id` string, required — ID of the integration
  - `team_id` string, required — ID of the project
  - `label` string, required — Label of the integration
  - `provider` 'AIPRISE' | 'AIRCALL' | 'ALCHEMY' | 'ATTENTIVE' | 'DOCUSIGN' | 'INTERCOM' | 'HMAC' | 'BASIC_AUTH' | 'API_KEY' | 'MANAGED' | 'HOOKDECK_OUTPOST' | 'SANITY' | 'BIGCOMMERCE' | 'CLAUDE' | 'OPENAI' | 'POLAR' | 'BRIDGE_XYZ' | 'BRIDGE_API' | 'CHARGEBEE_BILLING' | 'CHAINDOTS' | 'CLOUDSIGNAL' | 'COINBASE' | 'COURIER' | 'CURSOR' | 'MERAKI' | 'FIREBLOCKS' | 'FRONTAPP' | 'ZOOM' | 'TWITTER' | 'RECHARGE' | 'CRONOFY' | 'RECURLY' | 'RETELL' | 'REVOLUT' | 'RING_CENTRAL' | 'STRIPE' | 'CLOUDINARY' | 'PROPERTY-FINDER' | 'QUOTER' | 'SHOPIFY' | 'TWILIO' | 'GITHUB' | 'POSTMARK' | 'TALLY' | 'TYPEFORM' | 'PICQER' | 'XERO' | 'SVIX' | 'RESEND' | 'GEMINI' | 'ADYEN' | 'AKENEO' | 'GITLAB' | 'WOOCOMMERCE' | 'OKTA' | 'OURA' | 'COMMERCELAYER' | 'COMMUNITY' | 'HUBSPOT' | 'MAILERSEND' | 'MAILGUN' | 'PERSONA' | 'PIPEDRIVE' | 'SENDGRID' | 'WORKOS' | 'SYNCTERA' | 'AWS_SNS' | 'THREE_D_EYE' | 'TWITCH' | 'ELEVENLABS' | 'ENODE' | 'FAUNDIT' | 'FAVRO' | 'LINEAR' | 'SHIPBOB' | 'SHIPHERO' | 'SHOPLINE' | 'WIX' | 'NMI' | 'NEON' | 'ORB' | 'PYLON' | 'RAZORPAY' | 'REPAY' | 'SQUARE' | 'SOLIDGATE' | 'TRELLO' | 'EBAY' | 'TELNYX' | 'DISCORD' | 'TOKENIO' | 'FISERV' | 'FUSIONAUTH' | 'BONDSMITH' | 'VERCEL_LOG_DRAINS' | 'VERCEL' | 'TEBEX' | 'SLACK' | 'SMARTCAR' | 'MAILCHIMP' | 'NUVEMSHOP' | 'PADDLE' | 'PAYPAL' | 'PAYMOB' | 'PAYSTACK' | 'SCRAPFLY' | 'PORTAL' | 'TREEZOR' | 'PRAXIS' | 'CUSTOMERIO' | 'EXACT_ONLINE' | 'FACEBOOK' | 'WHATSAPP' | 'REPLICATE' | 'TIKTOK' | 'TIKTOK_SHOP' | 'AIRWALLEX' | 'ASCEND' | 'ALIPAY' | 'ZENDESK' | 'UPOLLO' | 'SMILE' | 'NYLAS' | 'CLIO' | 'GOCARDLESS' | 'GOOGLE_PUBSUB' | 'LINKEDIN' | 'LITHIC' | 'UTILA' | 'GREENDOT' | 'ZEROHASH' | 'AIRTABLE' | 'ASANA' | 'ASHBY' | 'FASTSPRING' | 'PAYPRO_GLOBAL' | 'USPS' | 'WALMART' | 'FIREFLIES' | 'FLEXPORT' | 'UBER' | 'WECHAT' | 'BUNNY_STREAM' | 'SHIPSTATION' | 'CIRCLE' | 'STATSIG' | 'VAPI' | 'VOLUME', required
  - `features` IntegrationFeature[], required — List of features to enable (see features list below)
  - `configs` union, required — Decrypted Key/Value object of the associated configuration for that provider
    - object
      - `webhook_secret_key` string, required
      - `algorithm` 'md5' | 'sha1' | 'sha256' | 'sha512', required
      - `header_key` string, required
      - `encoding` 'base64' | 'hex', required
    - object
      - `header_key` string, required
      - `api_key` string, required
    - object
      - `api_key` string, required
    - object
      - `webhook_secret_key` string, required
    - object
      - `username` string, required
      - `password` string, required
    - object
      - `webhook_secret_key` string, required
    - object
      - `webhook_secret_key` string, nullable
      - `vercel_log_drains_secret` string, required
    - object
  - `sources` string[], required — List of source IDs the integration is attached to
  - `updated_at` string, date-time, required — Date the integration was last updated
  - `created_at` string, date-time, required — Date the integration was created

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity

## Changes

- **2026-08-27** `091808eac7fa` — 2 warning, 2 info
  - added the new `CRONOFY` enum value to the `provider` response property for the response status `200`
  - added the new `MAILERSEND` enum value to the `provider` response property for the response status `200`
  - added the new `CRONOFY` enum value to the request property `provider`
  - added the new `MAILERSEND` enum value to the request property `provider`
- **2026-08-16** `00467503c60e` — 1 warning, 1 info
  - added the new `COMMUNITY` enum value to the `provider` response property for the response status `200`
  - added the new `COMMUNITY` enum value to the request property `provider`
- **2026-08-14** `784a986a2df4` — 1 warning, 1 info
  - added the new `AIRCALL` enum value to the `provider` response property for the response status `200`
  - added the new `AIRCALL` enum value to the request property `provider`
- **2026-08-12** `9ad0001dc832` — 1 warning, 1 info
  - added the new `GOOGLE_PUBSUB` enum value to the `provider` response property for the response status `200`
  - added the new `GOOGLE_PUBSUB` enum value to the request property `provider`

[Change history](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/changes/integrations/post.md)

---

[API](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/revisions/091808eac7fa/schema)