- HubSpot setup guide
- Partner Developer Documentation
- System
- Tenants
- Agents
- Tools
- Calls
- List callsGET
- Start an outbound callPOST
- Start an outbound call with an ad-hoc agentPOST
- Usage statisticsGET
- Detailed call statisticsGET
- Export all data for a data subjectGET
- Call statisticsGET
- Erase all calls for a data subjectDELETE
- Get call detailsGET
- Erase a single callDELETE
- Mark a call completedPOST
- Download a call transcriptGET
- Get a call recording URLGET
- Get the function/tool execution logGET
- Repair recording metadataPOST
- Diagnose recording availabilityGET
- List calls
- 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 providers
- List tenant connections
- Create an API-key connection
- Delete (disconnect) a connection
- Get a fresh access token for a connection
- Start an OAuth2 authorization flow
- OAuth2 redirect callback
- List actions for a provider
- List an agent's integrations
- Add an integration to an agent
- Update an agent integration's config
- Remove an integration from an agent
- Execute an integration action during a call
- Dispatch end-of-call integrations
- 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
Claim a number from the pool
POST
/api/phone-numbers/claim-from-pool
Request
Authorization
API Key
Add parameter in header
X-API-Key
Example:
X-API-Key: ********************or
Body Params application/jsonRequired
Examples
Responses
🟢200Success
application/json
Bodyapplication/json
🟠400
🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.snakk.ai/api/phone-numbers/claim-from-pool' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"phoneNumberId": "8e9ce3fb-4d22-4fe3-baa7-b7892dd942d7"
}'Response Response Example
200 - Example 1
{
"phone_number": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
"phone_number": "+4712345678"
},
"message": "Number claimed successfully",
"monthly_cost": 30
}Modified at 2026-07-08 19:01:40