Add Contact to AI Studio via API

Autobound's AI Studio is a campaign builder that lets you generate personalized sales content and insights at scale—based on your own data and logic.

One method of adding contacts to a campaign, is via. API, where you can then immediately trigger personalized content and insights.

Benefits include:

✅ Builder-friendly workflow: Easily set up and manage imports directly within your campaign.
✅ Full visibility with logs: Quickly debug and monitor imports and related actions from within your campaign interface.
✅ Flexible exports: Trigger content delivery to your CRM, sales tools (Outreach, Salesloft), or any custom API.
✅ Easier content testing: Immediately preview and validate personalized content and insights.
✅ Insight coverage testing: See exactly what insights Autobound finds per contact and adjust mappings to optimize personalization.

Configure these settings directly from within your campaign in AI Studio—no need for separate API endpoints or complex integrations.

🔗 Endpoint

POST /api/workflows/campaigns/{campaignId}/execute

Replace {campaignId} with your target Autobound AI Studio campaign ID.

🔐 Authentication

Include your Autobound API key in the request header:

X-API-KEY: YOUR-API-KEY-HERE

Don't have an API key yet? Generate one here →

🛠 Example Request

Here's a simple cURL example of adding a new contact:

curl --request POST \
     --url "https://api.autobound.ai/api/workflows/campaigns/fa8f6eb2-b184-429b-93ec-ccbf5f946610/execute/" \
     --header "Content-Type: application/json" \
     --header "X-API-KEY: YOUR-API-KEY-HERE" \
     --data '{
         "email": "[email protected]",          // suggest mapping to "contactEmail"
         "notes": "we met for coffee last week" // suggest mapping to "additionalContext"
     }'

🚨 Important: Mapping Fields After Import

You can pass in any key-value pairs you want—but Autobound won't auto-map them. After your first request:

Go to your AI Studio campaign.
Click the ⚙️ icon (Input Settings) on a content step.
Map your imported fields to resolution fields (e.g., contactEmail) and Content Hub overrides (valueProposition, salesAsset, additionalContext, etc.).

Your Field Name	Recommended Mapping
`email`	`Contact Email`
`notes`	`Additional Context`
`pitch`	`Value Proposition`
`assetUrl`	`Sales Asset`
`lang`	`Language`
`tone`	`Writing Style`

❗️ Error Handling

Status	Meaning	Recommended action
401	Unauthorized (missing/invalid API key)	Check and ensure your API key is correct and valid.
404	Campaign not found	Verify your campaign ID is correct.
422	Invalid payload or schema	Check your request payload.
500	Server error	Retry after a short delay; contact support if persistent.

🧠 Tips and Best Practices

Test first, scale second: Run test imports to check content quality and insight availability.
Map early: Map fields immediately after importing to avoid confusion later.
Monitor logs: Check import logs within AI Studio for easy troubleshooting.
Iterate quickly: Easily adjust mappings and regenerate insights and content without friction.