_
How to connect an API
-
🛠️ Practical tips (Checklist)
- URL field (required) : Copy and paste the full URL without spaces. Must begin with https://.
- Bearer key : Enter only the token (without the Bearer prefix). Leave empty for Make/Zapier.
- Mapping : Type the exact JSON name (case-sensitive). E.g. nom (not Nom).
- Body key : Leave empty in 95% of cases; only use it if the API requires it.
- Test : Always test with dummy data (e.g. nom="TEST", email="test@test.com").
- Logs : Check those of the destination (Make, Zapier or your API) to troubleshoot.
- Security : Never share your keys or webhook URLs publicly.
🔒 Safety
- Treat your webhooks like passwords.
- Use HTTPS exclusively.
- Regenerate a webhook URL if compromised.
- Use keys with limited permissions if possible.
🆘 Quick troubleshooting
Problem
Probable cause
Solution
Error 401
Incorrect or missing Bearer token
Check Bearer secret key (no spaces, valid)
Error 404
Incorrect URL
Copy and paste the complete URL again
Error 500
Problem on the receiving server
Check the recipient's logs
No answer
Inactive URL / service stopped
Check that the webhook/API is active
Missing data
Incorrect mapping
Check spelling of JSON names
Incorrect format
Data type not compatible
Check the expected types (text, number...)
📞 Need help?
- Proprietary API : Consult your developer or your API documentation.
- Make : https://www.make.com/en/help
- Zapier : https://help.zapier.com/