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, writing styles, and contexts from your own code or tools. 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, or 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

  • Styles - manage writing styles and their comment examples

  • Contexts - manage contexts, insights, and DM playbooks

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

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

The API key is for REST calls from your own code or tools. If you instead want to 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, not the API key - see Connect Extrovert to an AI assistant (MCP).

Did this answer your question?