Validate provider credentials and connect a scheduling integration
curl --request POST \
--url https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"credentials": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({credentials: {}})
};
fetch('https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations"
payload = { "credentials": {} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"message": "<string>",
"integration": {
"id": "<string>",
"connectionId": "<string>",
"providerKey": "cal",
"providerLabel": "<string>",
"authType": "oauth2",
"enabled": true,
"capabilityKeys": [
"<string>"
],
"config": {},
"connectionStatus": "pending",
"displayName": "<string>",
"externalAccountId": "<string>",
"lastErrorCode": "<string>",
"connectedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Agents
Validate provider credentials and connect a scheduling integration
Use an explicitly scoped user-bound account bearer credential or an application session. Scope grants are intersected with live membership, role, tenant isolation, agent access and plan limits; a credential does not grant an owner role. Invitation acceptance requires the verified recipient email.
POST
/
workspaces
/
{workspaceId}
/
agents
/
{agentId}
/
integrations
Validate provider credentials and connect a scheduling integration
curl --request POST \
--url https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"credentials": {}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({credentials: {}})
};
fetch('https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.communicate.so/api/v1/workspaces/{workspaceId}/agents/{agentId}/integrations"
payload = { "credentials": {} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"message": "<string>",
"integration": {
"id": "<string>",
"connectionId": "<string>",
"providerKey": "cal",
"providerLabel": "<string>",
"authType": "oauth2",
"enabled": true,
"capabilityKeys": [
"<string>"
],
"config": {},
"connectionStatus": "pending",
"displayName": "<string>",
"externalAccountId": "<string>",
"lastErrorCode": "<string>",
"connectedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
}Authorizations
accountBeareraccountSessionlocalAccountSession
Opaque user-bound ca_ account credential. Each request checks live account scopes, verified email, expiry, revocation and the issuer session. Not a workspace ck_ key or OAuth access token.
Path Parameters
Minimum string length:
1Minimum string length:
1Body
application/json