API & integrations
Connecting SendPulse step by step
How to give every SendPulse subscriber a personal link on your domain, protected by the Anti-Bot filter. About 15 minutes the first time, then two commands before each campaign.
Create fresh codes for every campaign. A code lives 60 days and opens the page up to 3 times, so a link saved into a subscriber field once and reused for months will stop working.
1Variable name: cl_link
In SendPulse, extra subscriber data lives in mailing list variables. You don't need to create anything in advance: you'll create the cl_link variable (type String) during import in step 6. The name must match exactly, including case, or SendPulse won't insert the link into the email.
2Get a link and a key
In your createlink.link dashboard create the link the campaign should lead to, or use an existing one — its number is LINK_ID. Then open the account menu → API and create a key named "SendPulse" — that is YOUR_KEY.
3Export the recipients from SendPulse
Export the list or segment you are going to send to as a CSV file and save it as export.csv. Note which column holds the email, counting from 1.
4Create the codes
Send the file to createlink.link. Replace LINK_ID and YOUR_KEY; if the email is not in the first column, change column=1.
curl -X POST "https://createlink.link/api/v1/links/LINK_ID/codes?column=1&skip_header=1" \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: text/csv" \ --data-binary @export.csv
The answer contains job_id. Up to 1,000 recipients are ready at once; a bigger list takes from a few seconds to a couple of minutes.
5Download the file for SendPulse
Put the job_id into the command. The file comes out with the column names SendPulse expects.
curl "https://createlink.link/api/v1/jobs/JOB_ID?format=csv&columns=email:ref,cl_link:url" \ -H "Authorization: Bearer YOUR_KEY" -o links.csv
If the batch is still running, you get a short message with "status": "running" instead of a file — repeat the command in a minute.
6Import the file into the same mailing list
Open the mailing list you send to → add contacts → "Upload file" and choose links.csv. Map the email column to email, and for the cl_link column create a new variable cl_link of type String. Make sure to turn on "Update variable values for existing contacts", or subscribers already in the list keep their old link. Then click "Add".
7Put the link into the email
In the email editor, use the tag {{cl_link}} as the address of a button or link, typed in or picked from the "Variables" button. In HTML it looks like this:
<a href="{{cl_link}}">…</a>
8Check link tracking
When tracking is on, SendPulse wraps every link in the email in its tracking domain (stat-pulse.com by default), and recipients see that domain instead of yours. Turn off link tracking for this send. SendPulse's help centre doesn't say exactly where this setting is, so check the result in a test email (next step): the link must start with your domain.
9Send a test to yourself
Add your own address to the list before step 3, send a test and check: the link in the letter starts with your domain, and clicking it opens your page. Only then send the campaign.