Base URL
All endpoints are served under a single versioned base URL:What you can do
- Sync contacts & accounts — upsert contacts by email or LinkedIn URL, query your roster, and manage custom variables on contacts and accounts.
- Manage exclusions — add or remove contact and company suppression rules.
- Control sequences — enroll contacts, pause or stop runs, and remove list entries that sourced a sequence.
- Read activities and messages — pull outreach events and message content.
- Manage contact & account lists — create and populate segmentation lists.
- Subscribe to webhooks — register endpoints to receive real-time event payloads.
- Manage tasks — list, create, execute, complete, and reassign outreach tasks and standalone to-dos.
- Push first-party events — send your own product and website signals into Topo.
Versioning
The major API version lives in the URL path (/v1). Topo follows these rules to keep your integration stable:
You should write your client to ignore unknown fields in responses. Topo may add new fields to any response object at any time within
/v1.
Quick start
Once you have an API key (see Authentication), make your first request to confirm your credentials and see which scopes your key carries:Explore the docs
Concepts
Meet every object the API exposes and find the endpoint group that covers it.
Authentication
Learn how to create API keys, pass them in requests, and scope them to least-privilege access.
Pagination & Filtering
Understand the standard list envelope, page through large result sets, and filter records.
Errors & Rate Limits
Decode error responses, handle rate limiting gracefully, and debug with request IDs.
Contacts
Read contacts in your workspace and manage their custom variables.
Events
Push first-party events so they become scored buying signals on the right contact.