Workspace
Organization
Your workspace, and the boundary of every API call. An API key belongs to exactly one organization and can never read or write another one, so requests carry no organization parameter. Confirm which organization a key is bound to with
GET /v1/me.User
A member of your organization. Users own contacts and accounts and are the assignees of tasks, so you need their ids to reassign work through the API.
People and companies
Contact
A person in your workspace — name, email, LinkedIn URL, job title, location, and employer. Contacts are the subject of outreach: sequences, tasks, and activities all reference one. You can also attach custom variables to a contact to feed CRM data and personalization tokens into Topo’s AI.
Account
A company in your workspace, keyed by its domain. Accounts carry firmographic data and are the target of account-based workflows, where you choose the companies to pursue and let Topo find the right people inside them. Like contacts, accounts hold custom variables shared by every contact linked to them.
Lists
Contact list and contact entry
A contact list is a staging area for prospects before they enter outreach. Each row in it is a contact entry — a raw candidate that Topo enriches and resolves to a verified contact. Create the list first, then add entries to it in batches.
Account list and account entry
The company equivalent: an account list holds target companies, and each account entry is one company you added by name and domain. Same two-step shape — create the list, then add its entries.
Outreach
Sequence template
The outreach playbook: the ordered steps to run, which channel each one uses, the sending schedule, and how many new leads to enroll per day. Templates are read-only over the API — build and edit them in the Topo app.
Sequence
One contact’s live run of a template, created when that contact is enrolled. It tracks their position and status, and it is the object you pause, resume, or stop when a deal changes.
Task
A manual action a sequence hands to a person — place a call, write a bespoke email, review a new lead. Tasks are assigned to a user and block the sequence step until they are completed or skipped.
Contact exclusion
A blocklist rule that suppresses outreach to one person by email or LinkedIn URL across every sequence. Carries a reason code and can be permanent or time-bound.
Account exclusion
A blocklist rule that suppresses outreach to an entire company domain across every sequence. Carries a reason code and can be permanent or time-bound.
Engagement
Activity
An immutable record of something that happened during outreach — a message sent, opened, clicked, or replied to, a hot lead flagged, a meeting booked. Activities are the queryable engagement log for your workspace, and each one embeds summaries of the contact, sequence template, and resource it touched, so you rarely need a follow-up request.
Webhook
A subscription that pushes activities to your endpoint as they occur, signed with HMAC-SHA256. Use webhooks instead of polling activities when you need events in near real time.
Event and buying signal
An event is something your systems observed about a prospect and pushed to Topo. Topo turns it into a buying signal — a scored, ICP-filtered indicator that a contact or account is worth contacting now. Signals detected by Topo itself, such as job changes and funding rounds, sit alongside the ones you send.
Activities and events point in opposite directions. An activity is outbound history Topo recorded and you read; an event is inbound intent you record and Topo reads.