Actions29
Overview
This node allows you to create a new lead in the BookedIn system. It is useful for adding potential customer or client contact information into your marketing, sales, or outreach workflows. Typical scenarios include capturing leads from web forms, importing contacts from other systems, or manually entering new prospects.
For example, you can use this node to:
- Add a lead collected from a website signup form.
- Import leads from an external CRM or spreadsheet.
- Manually add a lead during a sales call or event.
The node validates key fields such as phone number format and email correctness before sending the data to the BookedIn API.
Properties
| Name | Meaning |
|---|---|
| First Name | Lead's first name |
| Last Name | Lead's last name |
| Lead's email address (must be valid email format) | |
| Phone Number | Lead's phone number in international format starting with + (e.g., +12345678910) |
| Timezone | Lead's timezone (e.g., Europe/Madrid) |
| Source | Source of the lead; options: API, Import, Manual, Website |
| Custom Fields (Meta) | Additional metadata as a JSON object (e.g., {"campaign": "summer2024", "priority": "high"}) |
Output
The output is a JSON object representing the created lead as returned by the BookedIn API. This typically includes the lead's unique ID, contact details, source, metadata, and any other fields stored by the system.
No binary data is output by this node.
Dependencies
- Requires an API key credential configured in n8n to authenticate requests to the BookedIn API.
- The node makes HTTP POST requests to
https://api.bookedin.ai/api/v1/leads/endpoint.
Troubleshooting
- Phone number validation errors: The phone number must start with a plus sign (+), contain only digits after that, and be between 7 and 15 digits long. Remove spaces, dashes, or parentheses before inputting.
- Invalid email format: Ensure the email address follows standard email formatting rules.
- JSON parsing errors in Custom Fields (Meta): The meta field must be valid JSON. Use a JSON validator if unsure.
- Missing required contact info: At least one of email, name, or phone number must be provided.
- API authentication errors: Verify that the API key credential is correctly set up and has permissions to create leads.
- Network or API errors: Check network connectivity and BookedIn service status.
Links and References
- BookedIn API Documentation (for detailed API endpoints and data models)
- International Phone Number Formatting
- JSON Validator