BookedIn icon

BookedIn

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

Actions29

Overview

The "Execute Campaign" operation in this node triggers the execution of a specified campaign within the BookedIn platform. This involves processing a number of leads associated with the campaign, optionally limited by a user-defined count. The node sends a request to the BookedIn API to start the campaign execution, which typically means outreach or engagement activities defined by the campaign's strategy are carried out on the selected leads.

This operation is beneficial for automating marketing or sales campaigns where you want to programmatically initiate lead processing without manual intervention. For example, a sales team could use this node to launch an email or messaging campaign targeting a subset of leads from a list, controlling how many leads to engage at once.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to execute.
Lead Count Number of leads to process during execution (range 1-100). If left empty, uses full quota.

Output

The output JSON contains the response from the BookedIn API after attempting to execute the campaign. This typically includes details about the execution status, such as confirmation that the campaign started and possibly metadata about the leads processed or queued.

No binary data output is produced by this operation.

Example output structure (simplified):

{
  "id": "camp_1234567890",
  "status": "executing",
  "processed_leads_count": 25,
  "message": "Campaign execution started successfully"
}

Dependencies

  • Requires an API key credential configured in n8n to authenticate requests to the BookedIn API.
  • Network access to https://api.bookedin.ai is necessary.
  • Proper permissions on the BookedIn account to execute campaigns.

Troubleshooting

  • Invalid Campaign ID: If the campaign ID does not exist or is malformed, the API will return an error. Verify the campaign ID is correct.
  • Lead Count Out of Range: The lead count must be between 1 and 100 if specified. Values outside this range may cause errors.
  • Authentication Errors: Ensure the API key credential is valid and has not expired.
  • API Rate Limits: Frequent executions might hit rate limits; handle errors accordingly.
  • Empty Lead Count: Leaving lead count empty uses the full quota, but if the quota is exhausted, execution may fail or do nothing.

Links and References

Discussion