_
How to connect an API
-
🛠️ Practical tips (Checklist)
- URL field (required): Copy and paste the full URL without spaces. It must start with https://.
- Bearer key: Enter the token only (withouth the Bearer prefix). Leave blank for Make/Zapier.
- Mapping: Type the exact JSON name (case-sensitive). e.g. name (not Name).
- Body key: Leave empty in 95% of cases; use only if required by the API.
- Test: Always use dummy data for testing (e.g. name="TEST", email="test@test.com").
- Logs: Check destination logs (Make, Zapier or your API) to diagnose.
- Security: Never share your webhook keys or URLs publicly.
🔒 Safety
- Treat your webhooks like passwords.
- Use HTTPS only.
- 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 the API documentation.
- Make: https://www.make.com/en/help
- Zapier: https: //help.zapier.com/
