API documentation

Locate your API token, authenticate requests, and understand how to use the API securely.

The Agentalk API allows you to programmatically manage contacts, campaigns, and calls.

Use it to automate workflows, integrate with external systems, and control your workspace from your own applications.

What you can do with the API

The API allows you to manage core resources programmatically:

API Reference

Contacts

• Create or update contacts
• Search contacts
• Manage tags and custom fields
• Delete contacts

Campaigns

• Retrieve campaign lists
• Add contacts to campaigns
• Activate campaigns

Calls

• Initiate outbound calls
• Trigger calls in workflows
• Link calls to campaigns and contacts

Account

• Manage custom fields
• Retrieve phone numbers
• Manage organization-level tags

Endpoints

The complete list of endpoints from Agentalk API are available in the API Reference documentation.

Get your API token

To authenticate API requests, you need an API token.

1. Go to API & Integration from the sidebar.
2. Locate the API Token section.
3. Copy your active token.

   Keep your API token secure. Do not expose it in frontend code or public repositories.

You can manage your token in Organization Settings on the Account page.

Authenticate requests

All API requests must include your API token in the Authorization header using the Bearer format:

Authorization: Bearer YOUR_API_TOKEN

Each request is executed in the context of your organization.

Base URL

All API requests are made using the base URL:

https://api.agentalk.io

Endpoints are available under the /api/ path.

For example:

https://api.agentalk.io/api/contacts

Next steps

Here are the recommended next steps after completing this guide:

• API Reference: Explore all the endpoints available in the Agentalk API Reference.
• Use webhooks for post-call automation: Receive call data automatically after each call ends.