1. Setting Up Your API Import
Start in AI Studio:
Create a campaign in AI Studio.
Add Contacts via API:
Click the Actions button (top right), select Add Contacts, and choose Monitor from API request as the import source.
Get Your Campaign API Details:
A modal will appear, showing you the exact JSON request format and the unique campaign ID you’ll need for your requests.
Tip: Use the campaign ID shown in the modal—each campaign has its own.
Create & Use an API Key:
To authenticate your API requests, generate an API key in Autobound under Settings > API. Add this key to your API requests.
2. Parameters & Data Fields
You can provide a range of parameters in your API request to control what data is imported and used for content generation.
Mandatory Parameters
You must provide either the prospect’s email (contactEmail) or LinkedIn profile URL (contactLinkedinUrl) in your API request.
Examples Request:
curl --request POST \
--url "https://api.autobound.ai/api/workflows/campaigns/9c4dc492-391c-472c-b6b4-b31dd4ec98ef/execute/" \
--header "Content-Type: application/json" \
--header "X-API-KEY: YOUR-API-KEY-HERE" \
--data '{
"contactEmail": "johndoe@example.com"
}'
Optional Parameters
You can include any additional data fields you want (such as contact name, company name, job title, etc.).
If you provide a contact’s name or company name, these will override the values Autobound would otherwise resolve from the LinkedIn profile or email address you submit. This lets you control exactly which name or company is used in content generation.
3. Bringing In & Exposing Custom Data Fields
If you want to import custom data fields with your API request, simply include them in your request payload.
Example Request:
curl --request POST \
--url
"https://api.autobound.ai/api/workflows/campaigns/9c4dc492-391c-472c-b6b4-b31dd4ec98ef/execute/" \
--header "Content-Type: application/json" \
--header "X-API-KEY: YOUR-API-KEY-HERE" \
--data '{
"contactEmail": "johndoe@example.com",
“contactName”: “John”,
“contactCompanySize”: 10000
}'
After the import:
Click the API/source icon in the far left of your Prospects table to view all raw data sent for that contact.
Hover over any piece of raw metadata and click Add as column.
This creates a new column in your campaign table. Any future imports with this field will be mapped automatically.
Check this video below:
4. Table and Row Behavior
Row Organization: Imported prospects appear immediately in the Prospects Tab, organized in a lookup → action → export flow.
Error States: If data is missing or invalid, error states display in red with tooltips for guidance.
Action Processing: Cells linked to insights or content only process if required data is present. If auto-run is off, you’ll need to manually trigger actions.
Failed Imports & Debugging: Inline errors in cells and logs help you troubleshoot and fix issues quickly.
5. Reviewing Data and Logs
Both the “Data In” (your API request) and “Logs” (Autobound’s response) are available when you expand a row’s source details. Use these to verify your input, check output, and debug as needed.
See also: