- HubSpot setup guide
- Partner Developer Documentation
- System
- Tenants
- Agents
- Tools
- Calls
- List calls
- Start an outbound call
- Start an outbound call with an ad-hoc agent
- Usage statistics
- Detailed call statistics
- Export all data for a data subject
- Call statistics
- Erase all calls for a data subject
- Get call details
- Erase a single call
- Mark a call completed
- Download a call transcript
- Get a call recording URL
- Get the function/tool execution log
- Repair recording metadata
- Diagnose recording availability
- Phone Numbers
- Statistics
- Subscription
- Web Access
- AI Tools
- Account
- Platform Admin
- Knowledge Base
- Chat Widget
- Get public widget config
- Start a chat session
- Send a chat message
- Get chat history
- Poll session status
- Poll session status (POST)
- Get full widget config
- Update widget config
- Upload chat avatar
- Delete chat avatar
- List all chat sessions
- Get session with messages
- Close a chat session
- Close inactive sessions
- Get chat stats
- Version History
- Workflows
- Chat Operator
- Chat Verification
- Tool Logs
- Admin (internal)
- Trigger synthetic error
- List customers without a payment provider
- List all customers with details
- Manually set a customer's plan
- Detailed platform statistics
- List all tenants
- Get tenant details
- Update a tenant
- Purge a tenant
- List all agents
- Edit any agent
- List all calls
- Platform-wide statistics
- Revenue breakdown by month
- Bulk-purchase phone numbers
- List all phone numbers (pool)
- Import owned numbers from telephony connection
- Reset a tenant's monthly usage
- Retrieve a tenant's API key
- List call routing rules
- Sync call routing rules
- List subscription upgrade requests
- Approve a subscription request
- Reject a subscription request
- Update a customer's subscription
- Get a customer's monthly usage history
- Run the retention sweep now
- List deletion certificates
- List resellers
- Create a reseller
- Cross-reseller billing overview
- Update a reseller
- Import a number series into inventory
- List number inventory
- Bulk-allocate a number range to a reseller
- Allocate a single number
- List reseller admins
- Add or invite a reseller admin
- Revoke a reseller admin
- Attach a tenant to a reseller
- Set and attach a reseller domain
- Get reseller domain status
- Sync authentication redirect allow-list
- Get a reseller's billing basis
- Agent builder
- AI assist
- Auth & onboarding
- Billing
- Branding
- Calendar
- Google calendar OAuth callback
- Outlook calendar OAuth callback
- Get Google calendar authorization URL
- Get Outlook calendar authorization URL
- List calendar connections
- Disconnect a calendar
- List calendars within a connection
- Get an agent's calendar configurations
- Attach a calendar to an agent
- Update an agent calendar configuration
- Remove a calendar from an agent
- Check available appointment slots
- List a customer's bookings
- Book an appointment
- Cancel an appointment
- Chat
- Privacy & GDPR
- Identity verification
- List service connections
- Create or update a service connection
- Delete a service connection
- Update test user settings on a connection
- Test a service connection
- Initiate BankID/eID caller verification
- Check BankID/eID verification status
- Check BankID/eID verification status by room
- List all available verification methods
- Initiate Vipps caller verification
- Check Vipps verification status
- Check Vipps verification status by room
- List verification logs
- Get verification statistics
- Anonymize a verification record (GDPR)
- Get verification retention policy
- List marketplace tools
- List an agent's marketplace tools
- Add a marketplace tool to an agent
- Update an agent's tool settings
- Remove a tool from an agent
- Get enabled eID methods for the tenant
- Integrations
- List available integration providersGET
- List tenant connectionsGET
- Create an API-key connectionPOST
- Delete (disconnect) a connectionDELETE
- Get a fresh access token for a connectionGET
- Start an OAuth2 authorization flowGET
- OAuth2 redirect callbackGET
- List actions for a providerGET
- List an agent's integrationsGET
- Add an integration to an agentPOST
- Update an agent integration's configPATCH
- Remove an integration from an agentDELETE
- Execute an integration action during a callPOST
- Dispatch end-of-call integrationsPOST
- List available integration providers
- Invites
- Knowledge base
- Organizations
- Partner
- Phone numbers
- Wholesale
- Reseller
- Get the current reseller
- Update reseller branding and settings
- List resellers the admin belongs to
- Get portal domain and DNS status
- Upload a branding image
- List packages
- Create a package
- Update a package
- Delete a package
- List customers
- Create a customer
- Update a customer
- Permanently delete a customer
- List a customer's members and invites
- Invite a user into a customer org
- Revoke a pending invite
- Remove a member from a customer org
- Get act-on-behalf access for a customer
- Portfolio usage and billing for a month
- Portfolio call analytics for a month
- Top conversation topics for a month
- List the number pool
- Add a number to the pool
- Assign or release a number
- Remove a number from the pool
- List reseller staff
- Add a reseller staff member
- Change a staff member's role
- Remove a staff member
- List a customer's topups for a month
- Add a topup on a customer's behalf
- Export billing basis as CSV
- List email templates
- Override an email template
- Send a test email template
- Preview an email template
- Upload an email image asset
- Count newsletter recipients
- List past newsletters
- Send a newsletter
- Preview a newsletter
- List deletion certificates
- Export a data subject for a customer
- Erase a data subject for a customer
- Get sending domain status
- Register a sending domain
- Remove the sending domain
- Re-verify sending domain DNS
- Send a test email from the sending domain
- List integration OAuth providers
- Set integration OAuth credentials
- Remove integration OAuth credentials
- Reseller
- Support
- Tool logs
- Top-ups
- Users
- Web access
- Webhooks
- End-of-call webhooks
- Schemas
Create an API-key connection
POST
/api/integrations/connections
Request
Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************or
Body Params application/jsonRequired
Examples
Responses
🟢201
application/json
Bodyapplication/json
🟠400
🟠404
🔴500
🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.snakk.ai/api/integrations/connections' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"provider_slug": "example-crm",
"credentials": {
"api_key": "sk_live_xxx",
"email": "user@example.com"
},
"account_label": "My Example CRM account"
}'Response Response Example
201 - Example 1
{
"success": true,
"connection": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
"provider_id": "fe3d49af-4061-436b-ae60-f7044f252a44",
"account_label": "string",
"account_identifier": "string",
"is_active": true
}
}Modified at 2026-07-08 19:01:40