---
title: "Link customer integration"
method: POST
path: "/api/v1/customers/{id}/integrations"
tags: ["Customer Integrations"]
---

# Link customer integration

`POST /api/v1/customers/{id}/integrations`

Links a customer to an external integration by specifying the vendor and external entity ID.

## Path parameters

- `id` string, required

## Headers

- `X-ACCOUNT-ID` string
- `X-ENVIRONMENT-ID` string

## Request body

- CreateCustomerIntegrationRequestDto — Links a customer to an external integration.
  - `id` string, required — Integration details
  - `vendorIdentifier` 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL' | 'AIRWALLEX' | 'STRIPE_INVOICING', required — The vendor identifier of integration
  - `syncedEntityId` string, required — Synced entity id

## Response `201`

The created customer integration object.

- CustomerIntegrationResponseDto — Response object
  - `data` object, required — External billing or CRM integration link
    - `id` string, required — Integration details
    - `vendorIdentifier` 'AUTH0' | 'ZUORA' | 'STRIPE' | 'HUBSPOT' | 'AWS_MARKETPLACE' | 'SNOWFLAKE' | 'SALESFORCE' | 'BIG_QUERY' | 'OPEN_FGA' | 'APP_STORE' | 'RECEIVED' | 'PREQUEL' | 'AIRWALLEX' | 'STRIPE_INVOICING', required — The vendor identifier of integration
    - `syncedEntityId` string, nullable, required — Synced entity id
    - `syncData` union
      - object — Price billing sync revision data containing billing ID, link URL, and price group package billing ID
        - `billingId` string, required — Billing integration id
        - `billingLinkUrl` string, required — Billing integration url
        - `priceGroupPackageBillingId` string, required — Price group package billing id
      - object — Billing sync revision data containing billing ID and link URL
        - `billingId` string, required — Billing integration id
        - `billingLinkUrl` string, required — Billing integration url
      - object — Marketplace sync revision data containing dimensions
        - `dimensions` string, required — Dimensions of the marketplace sync revision

## Other responses

- `400` — bad request.
- `401` — User is not authenticated.
- `403` — User is not allowed to access this resource.
- `409` — CustomerIntegration conflict error.
- `429` — Too many requests.

---

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