Send leads from the Blastform API to an external API

🎯 General principle

When a form is submitted, the data is automatically sent to the configured URL as an HTTP POST request with information in JSON format.

Each form has its own configuration. To set it up: Settings → API Lead Configuration.

📸 Configuration interface

The API Lead Configuration page has 3 main areas:

1. URL* The address to send data to (required).
2. Secret key (Bearer Authentication): Used to secure the transmission (sent in headers).
3. Field mapping: Correspondence between your form fields and JSON names.

• Left column: The form field (e.g. Last name, Email, Mobile phone)
• Right column: The name to be sent as JSON (e.g. name, email, mobile_phone)

1. Secret key (body): Optional key sent in the request body.

💡 You can add as many mappings as you need with the + Add field button.

• • To your proprietary API or another API

    When to use it: When you've developed your own system (CRM, database) with an API.

    Example configuration

    • URL: https://api.yourcrm.com/leads
    • Secret key (Bearer): sk_live_abcd1234xyz...
    • Field mapping:

     

    Field (form)	JSON field name	Example
    Last name	name	“Doe”
    Email	email	"contact@example.com"
    Cell phone	mobile_phone	“+12135096995”

    Secret key (body) (optional): api_key_2024

    Example of a sent request

    POST https://api.votrecrm.com/leads
    Headers:
      Authorization: Bearer sk_live_abcd1234xyz…
      Content-Type: application/json

    Body:
    {
      « nom »: « Doe »,
      « email »: « contact@example.com »,
      « mobile_phone »: « +12135096995″,
      « secretKey »: « api_key_2024 »
    }

    Checkpoints

    • ✅ Your API must accept POST requests.
    • ✅ Elle doit gérer l’authentification Bearer (si utilisée).
    • ✅ Les noms de champs JSON doivent correspondre exactement (sensible à la casse).
    • ✅ Testez avec un outil comme Postman avant de connecter le formulaire en production.
• If you still having trouble, don't hesitate to contact our support team – they will be happy to assist you free of charge.