Link Console API and webhooks

On Pro, the workspace owner creates an API key in Integrations to create and update links from other systems with the same naming rules, and owners and editors can send every link change to a webhook URL.

Connect another system

1. Create an API key
   Open Integrations, API. Type a Key name, for example "HubSpot workflow", and press Create API key. Press Copy key now: it is shown only once.
2. Call the API
   Send the key as Authorization: Bearer lc_... to https://links.planconversion.com/api/v1. Every endpoint and field is in the API reference.
3. Handle naming errors
   A link that breaks your rules gets a 422 response with an issues list, one entry per problem. Fix the values, or add them to your approved values.
4. Add a webhook
   Under Webhooks (Zapier, Make, n8n), paste an https URL, for example from Zapier's "Webhooks by Zapier, Catch Hook" or Make's "Custom webhook", and press Save. Press Send test to try it.
5. Verify the signature
   The owner presses Copy signing secret. Each request carries X-LinkConsole-Signature: the hex HMAC-SHA256 of the raw body with that secret.
6. Revoke keys you no longer need
   Press Revoke next to a key in the list. It stops working at once.

Example

curl -X POST https://links.planconversion.com/api/v1/links \
  -H "Authorization: Bearer lc_your_key" -H "content-type: application/json" \
  -d '{"destination":"https://www.example.com/demo","utm_source":"linkedin","utm_medium":"paid-social","utm_campaign":"q4-abm","short":true}'

Good to know

• A workspace can have up to 10 active keys. Keys are stored only as a hash, and the list shows when each was last used.
• Other errors: 401 for a missing, unknown or revoked key; 402 when the workspace is not on Pro or a plan limit was reached; 409 when a short link ending is taken.
• Webhook events: link.created, link.edited, link.archived, link.restored, link.broken and link.recovered, sent within 5 minutes of the change.
• Failed deliveries (no answer or a server error) are retried for 24 hours. A 4xx answer is not retried.
• Only the owner manages API keys. Owners and editors can save the webhook URL.

Related articles

• Naming rules and approved valuesSet how every value is written, which parameters are required, and lock parameters to an approved list with requests.
• Link health monitorEvery saved link is opened daily like a visitor would, and broken pages or lost UTMs are flagged and emailed.
• Templates, the bulk builder and spreadsheet checksSave reusable templates, build up to 1,000 links from a CSV on Pro, and check the spreadsheet your team uses today.
• Troubleshooting common problemsFixes for scripts that stop reporting, CNAME records that aren't detected, 422 naming errors and the Free user limit.