Start here
Choose a connection, then make your first read-only request.
Connect Acquisity to another tool to check results, find leads or manage cold email campaigns.
Use the API
Connect an AI assistant
Make your first API request
You need access to a workspace with Public API access enabled. This example only reads information.
Create your key
Follow Create an API key. Select workspaces:read and campaigns:read for this walkthrough.
Find your workspace
Run this in a terminal, replacing <token> with your key. Keep the key private.
curl https://api.acquisity.ai/v1/workspaces \
-H "Authorization: Bearer <token>"Look inside data for your workspace and copy its id. Use the ID, not its name or URL slug.
List its campaigns
Replace <workspaceId> with that ID and <token> with your key.
curl https://api.acquisity.ai/v1/workspaces/<workspaceId>/campaigns \
-H "Authorization: Bearer <token>"Success: an HTTP 200 response with a data list of campaigns. An empty data list is a successful request with no matching campaigns. If links.next is present, follow it to read the next page.
Choose your next task
- Check campaign results
- Find and export leads
- Create a draft campaign
- Receive updates automatically with webhooks
If a request fails, use Understand errors.