Notify Follow Up Boss about marketing emails sent, opens, clicks, bounces, unsubscribes and spam reports.
Use this endpoint to send information to Follow Up Boss about marketing emails sent out from your application and related events such as opens, clicks, bounces, unsubscribes and spam reports.
Before sending email marketing events you need to create an email campaign which represents a marketing email in your system. This could be a one-off email blast or automated drip email. Use POST /emCampaigns endpoint to create an email campaign and save id field from the response - this is Follow Up Boss ID of the email campaign, then use that ID in the campaignId field when sending email marketing events to Follow Up Boss.
The following event types are supported:
delivered - Email was sent out to a recipient. open - Recipient opened the email. click - Recipient clicked on a link in the email. bounced - Email bounced, it means recipient's email server rejected the email. This is a generic bounce event, use it if your system doesn't distinguish between soft and hard bounces. soft-bounce - Email bounced temporarily. hard-bounce - Email bounced permanently. unsubscribe - Recipient unsubscribed from further emails. spamreport - Recipient reported email as spam. dropped - Sending email wasn't attempted because of the previous history with recipient (bounced, unsubscribed, etc).
userId is an optional field that allows you to specify the ID of the user in Follow Up Boss that email was sent from. This is useful to display email correctly in Follow Up Boss including replacing merge fields with correct user name, email, etc. This field is optional and defaults to the current authenticated user (the user whose API key is being used to authenticate API request).
This endpoint allows sending multiple events in a batch request, this is especially useful for delivered event type when you are sending out an email to a large number of recipients. You can send up to 1000 events per API request. When sending an email to a large number of recipients, we recommend breaking down the list of recipients into batches of 1000 and send each batch in a separate POST request to /v1/emEvents endpoint.
Any events sent over where Follow Up Boss was unable to find an associated contact for the listed recipient will be skipped over. No event will be created in this case. All other found matches will have events created successfully.
Click Try It! to start a request and see the response here!