Set Up API Keys and Webhooks

Use API keys and webhooks when external systems need to connect leads, integrations, or automations with Pragma.

Prerequisites

• You are an owner or master user in the workspace.
• The workspace is active and not locked by an expired trial.
• For webhooks, you have an HTTPS endpoint that accepts POST requests.

Create an API Key

1. Open Platform & API in the app.
2. Go to API Keys.
3. Click New API Key.
4. Use a clear name, such as Zapier Lead Import or Backend Sync.
5. Select only the scopes the system needs.
6. Create the key and copy the token immediately. It is shown once.

curl https://app.mikemuellers.de/api/leads \
  -H "Authorization: Bearer <your-api-key>"

Register a Webhook

1. Open Platform & API.
2. Go to Webhooks.
3. Enter the target URL.
4. Select events such as lead.created or crm.synced.
5. Save the webhook.
6. Send a test delivery and confirm your target system receives it.

Common Events

Event	Trigger
lead.created	Lead created via UI, CSV, or API
lead.updated	Lead fields or stage changed
lead.scored	AI score calculated
followup.created	Follow-up task created
crm.synced	Lead synced to HubSpot, Pipedrive, or Salesforce

Troubleshooting

• 401: Token missing or malformed. Check Authorization: Bearer ....
• 403: User or key does not have enough permissions.
• 423: Workspace is locked, usually because the trial expired.
• Webhook not received: Check HTTPS, firewall, response status, and response time.