Create connector

Connect the workspace to an integration. The connector holds no credentials yet. The first connector of an application takes every licence of that application that no connector holds. A second connector of the same integration and method answers 409.

POST

/v1/connectors

POST

/connectors

curl -X POST "https://api.corma.io/v1/connectors" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "google",
  "method": "api"
}'

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

x-corma-idempotency-key
string
header
Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Body

application/json

kind
enum<string>
required
The integration to connect.
One of:
google
microsoft
okta
onelogin
pennylane
spendesk
qonto
candis
agicap
payhawk
slack
lastpass
onepassword
github
atlassian
notion
miro
hubspot
salesforce
aircall
zendesk
deskpro
intercom
linear
figma
front
adobe
asana
dashlane
modjo
aws
dropbox
openai
docusign
datadog
deel
freshservice
freshdesk
freshcaller
canva
gong
zoho
cloudflare
calendly
diabolocom
jamf
cursor
quable
quableportal
gitlab
udemy
amplitude
zoom
autodesk_bim_360
jumpcloud
claude_ai
claude_platform
bitwarden
clickup
make
brevo
yousign
leexi
posthog
odoo
eurecia
ringover
rippling
akuiteo
yooz
snowflake
personio
coda
merge_factorial
bamboohr
payfit
lucca
yoobic
tableau
monday
chatgpt
fxbo
siit
airtable
voiso
moss
hibob
tomorro
factorial
kelio
workday
silae
method
enum<string>
required
How Corma connects to the integration.
One of:
api
agent
nango
name
string | null
The name of the connection. Corma names it when the connection gets its credentials if you leave it empty.

Response

application/json201

id
string
required
Opaque identifier of the connector. Treat it as a string: pass back the value the API returned, and do not build it or parse it. Its form will change to the id of the connection; every route accepts both forms.
kind
enum<string>
required
The integration this connector connects to.
One of:
google
microsoft
okta
onelogin
pennylane
spendesk
qonto
candis
agicap
payhawk
slack
lastpass
onepassword
github
atlassian
notion
miro
hubspot
salesforce
aircall
zendesk
deskpro
intercom
linear
figma
front
adobe
asana
dashlane
modjo
aws
dropbox
openai
docusign
datadog
deel
freshservice
freshdesk
freshcaller
canva
gong
zoho
cloudflare
calendly
diabolocom
jamf
cursor
quable
quableportal
gitlab
udemy
amplitude
zoom
autodesk_bim_360
jumpcloud
claude_ai
claude_platform
bitwarden
clickup
make
brevo
yousign
leexi
posthog
odoo
eurecia
ringover
rippling
akuiteo
yooz
snowflake
personio
coda
merge_factorial
bamboohr
payfit
lucca
yoobic
tableau
monday
chatgpt
fxbo
siit
airtable
voiso
moss
hibob
tomorro
factorial
kelio
workday
silae
method
enum<string>
required
How Corma reaches the integration.
One of:
api
agent
nango
name
string
required
The name of the integration, as Corma displays it. The name of this connection is connectionName.
connectionName
string | null
required
The name the workspace gave this connection. Null until it is named.
logoUrl
string<uri> | null
required
The logo of the connector. Null when Corma has none.
connectedAt
string<date-time> | null
required
The timestamp of when the workspace connected this connector. ISO 8601 format. Null when the connection holds no credentials.

{
  "id": "string",
  "kind": "google",
  "method": "api",
  "name": "string",
  "connectionName": "string",
  "logoUrl": "https://example.com",
  "connectedAt": "2026-01-15T09:30:00Z"
}

POST

/connectors

curl -X POST "https://api.corma.io/v1/connectors" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "google",
  "method": "api"
}'

{
  "id": "string",
  "kind": "google",
  "method": "api",
  "name": "string",
  "connectionName": "string",
  "logoUrl": "https://example.com",
  "connectedAt": "2026-01-15T09:30:00Z"
}

Create connector - Corma Help Center | Productlane

API referenceConnectors

Create connector

POST

/v1/connectors

POST

/connectors

curl -X POST "https://api.corma.io/v1/connectors" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "google",
  "method": "api"
}'

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

x-corma-idempotency-key
string
header
Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Body

application/json

kind
enum<string>
required
The integration to connect.
One of:
google
microsoft
okta
onelogin
pennylane
spendesk
qonto
candis
agicap
payhawk
slack
lastpass
onepassword
github
atlassian
notion
miro
hubspot
salesforce
aircall
zendesk
deskpro
intercom
linear
figma
front
adobe
asana
dashlane
modjo
aws
dropbox
openai
docusign
datadog
deel
freshservice
freshdesk
freshcaller
canva
gong
zoho
cloudflare
calendly
diabolocom
jamf
cursor
quable
quableportal
gitlab
udemy
amplitude
zoom
autodesk_bim_360
jumpcloud
claude_ai
claude_platform
bitwarden
clickup
make
brevo
yousign
leexi
posthog
odoo
eurecia
ringover
rippling
akuiteo
yooz
snowflake
personio
coda
merge_factorial
bamboohr
payfit
lucca
yoobic
tableau
monday
chatgpt
fxbo
siit
airtable
voiso
moss
hibob
tomorro
factorial
kelio
workday
silae
method
enum<string>
required
How Corma connects to the integration.
One of:
api
agent
nango
name
string | null
The name of the connection. Corma names it when the connection gets its credentials if you leave it empty.

Response

application/json201

id
string
required
Opaque identifier of the connector. Treat it as a string: pass back the value the API returned, and do not build it or parse it. Its form will change to the id of the connection; every route accepts both forms.
kind
enum<string>
required
The integration this connector connects to.
One of:
google
microsoft
okta
onelogin
pennylane
spendesk
qonto
candis
agicap
payhawk
slack
lastpass
onepassword
github
atlassian
notion
miro
hubspot
salesforce
aircall
zendesk
deskpro
intercom
linear
figma
front
adobe
asana
dashlane
modjo
aws
dropbox
openai
docusign
datadog
deel
freshservice
freshdesk
freshcaller
canva
gong
zoho
cloudflare
calendly
diabolocom
jamf
cursor
quable
quableportal
gitlab
udemy
amplitude
zoom
autodesk_bim_360
jumpcloud
claude_ai
claude_platform
bitwarden
clickup
make
brevo
yousign
leexi
posthog
odoo
eurecia
ringover
rippling
akuiteo
yooz
snowflake
personio
coda
merge_factorial
bamboohr
payfit
lucca
yoobic
tableau
monday
chatgpt
fxbo
siit
airtable
voiso
moss
hibob
tomorro
factorial
kelio
workday
silae
method
enum<string>
required
How Corma reaches the integration.
One of:
api
agent
nango
name
string
required
The name of the integration, as Corma displays it. The name of this connection is connectionName.
connectionName
string | null
required
The name the workspace gave this connection. Null until it is named.
logoUrl
string<uri> | null
required
The logo of the connector. Null when Corma has none.
connectedAt
string<date-time> | null
required
The timestamp of when the workspace connected this connector. ISO 8601 format. Null when the connection holds no credentials.

{
  "id": "string",
  "kind": "google",
  "method": "api",
  "name": "string",
  "connectionName": "string",
  "logoUrl": "https://example.com",
  "connectedAt": "2026-01-15T09:30:00Z"
}

POST

/connectors

curl -X POST "https://api.corma.io/v1/connectors" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "google",
  "method": "api"
}'

{
  "id": "string",
  "kind": "google",
  "method": "api",
  "name": "string",
  "connectionName": "string",
  "logoUrl": "https://example.com",
  "connectedAt": "2026-01-15T09:30:00Z"
}