Skip to main content
POST
Create an integration
Requires an API key with the environment:integrations:create scope. Learn more about API key scopes.

Authorizations

Authorization
string
header
required

An Environment API key from your Nango environment, or an Account API key for account-level endpoints.

Body

application/json
unique_key
string
required

A unique integration ID, which you will use in the other API calls to reference this integration.

provider
string
required

The provider unique name.

display_name
string

The integration display name.

forward_webhooks
boolean

Whether to forward webhooks received for this integration. Defaults to true.

credentials
object

Developer app credentials for the integration. Omit them to create the integration without credentials and provide them later, either with an update request or per connection at connection time.

integration_config
object

Provider-specific configuration for providers that declare an integration_config schema (e.g. private-api-generic, aws-sigv4). Keys and required fields depend on the provider; values are validated against the provider schema.

Response

Successfully created an integration

data
object
required