BookedIn icon

BookedIn

Interact with BookedIn AI agents, leads, campaigns, strategies, lists, and human messaging
Join our community

Actions29

Overview

This node integrates with the BookedIn API to manage various marketing and sales-related entities such as agents, leads, lists, strategies, campaigns, and human messages. Specifically for the List resource with the Get Many operation, it retrieves multiple lists or the leads within a specific list, supporting pagination through skip and limit parameters.

Common scenarios where this node is beneficial include:

  • Fetching all prospect or customer lists for analysis or reporting.
  • Retrieving leads associated with a particular list to target them in campaigns.
  • Automating workflows that require bulk access to lists or their leads.

For example, you might use this node to get all your sales prospect lists with pagination, then process each list's leads for outreach campaigns.

Properties

Name Meaning
Skip Number of records to skip for pagination (used to offset the starting point of results).
Limit Maximum number of records to return (controls page size for results).

These properties apply when fetching multiple lists (getAll) or leads within a list (getListLeads).

Output

The node outputs JSON data representing the retrieved lists or leads depending on the operation:

  • For getAll on lists: An array of list objects, each containing details like list ID and name.
  • For getListLeads: An array of lead objects belonging to the specified list.

The output is structured as an array of JSON objects, each corresponding to one record from the API response.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating requests to the BookedIn API.
  • The node makes HTTP requests to endpoints under https://api.bookedin.ai/api/v1/.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Invalid Pagination Parameters: Providing negative values for skip or limit may cause errors or unexpected results. Ensure these are zero or positive integers.
  • API Authentication Errors: If the API key is missing or invalid, the node will fail to authenticate. Verify the API credential setup.
  • Empty Results: If no lists or leads are returned, check that the account has data and that pagination parameters are correct.
  • Rate Limits: Excessive requests may hit API rate limits; consider adding delays or reducing request frequency.
  • Malformed Input: Although minimal input is required for this operation, ensure that listId is provided and valid when fetching leads in a list.

Links and References

Discussion