Skip to main content

Using the Extrovert API

What the Extrovert REST API does, how to create your API key, which plans include it, and where to find the full reference.

Written by Denis Bauer

Extrovert has a REST API, so you can manage your campaigns, prospects, topics, and voices from your own code or tools, and work through your comment and DM queue programmatically. It's the programmatic way to do what you'd otherwise do in the dashboard. For no-code automations and webhooks, see Integrations.

Available on Business and Pro plans (and during the trial).

Get your API key

  1. Go to Settings → Integrations → API keys.

  2. Click Add API key.

  3. Copy the key and store it somewhere safe - it's shown only once.

Treat the key like a password. If you lose it, create a new one and delete the old one.

Base URL and authentication

Requests without a valid key return a 401. Requests on a plan that doesn't include API access return a 403.

What you can do with it

  • Campaigns - list, create, update, start and stop, duplicate, share, and transfer Prospects and Topic campaigns

  • Prospects and prospect lists - search prospects, look one up by profile URL, add prospects to a list, and move, mark important, or remove them

  • Monitored topics - create and manage the AI topics used for post discovery, and set which topics a Topic campaign tracks

  • Voices - list, create, duplicate, update, and delete voices, and manage their comment examples, talking points, selling points, and DM templates

  • Comments - list the comments waiting for review and read one, generate or improve a draft, set its exact text, choose whether approving posts a comment or a reaction or both, then approve, cancel posting, skip, or unskip

  • DM conversations and replies - list conversations and read one, prepare a reply, improve or edit it, send it, and recover a draft after a failure

  • Workspace and team - read your plan's features and quotas, and list your team members

Comments and DMs sent through the API go out under the same daily limits, working hours, and safety rules as anything you approve in the dashboard.

The full reference, with every endpoint and examples, lives at api-docs.goextrovert.com. To find the IDs you'll pass in requests, see where to get the Campaign Id and Prospect list Id.

API key vs. connecting an AI assistant

Both surfaces now cover the same ground, including the comment and DM queue. The difference is how you drive them.

The API key is for REST calls from your own code or tools, and it's the right choice when you want something scripted, scheduled, or repeatable. If you'd rather run Extrovert from an AI assistant like Claude or ChatGPT in plain language, that's a separate connection that signs in with your Extrovert account instead of the API key - see Connect Extrovert to an AI assistant (MCP).

Did this answer your question?