How to sync Calendly routing responses to Salesforce
Calendly syncs routing form responses to Salesforce, automating contact/lead updates and centralizing reporting, while enabling lead retargeting.
This feature isn't compatible with organizations using Marketo, HubSpot, or Pardot forms. To sync form responses, use their integrations with Salesforce instead.
How routing responses sync to Salesforce
When a Calendly routing form is submitted, the Salesforce integration creates a CalendlyRoutingFormSubmission record and a CalendlyRoutingFormQuestionsAnswers record for each question asked on the form. The creation of the CalendlyRoutingFormSubmission record triggers the flow CreateRoutingFormLeadTemplate.
Multiple records are created in Salesforce for each routing form submission in a single API request using Salesforce's composite API, helping avoid hitting API limits.
Default flow
This flow is fully customizable, but works in the following way by default.
- The flow loops through the CalendlyRoutingFormQuestionsAnswers records related to the CalendlyRoutingFormSubmission until it finds a name question. This will be the lead's name if the flow can't find a record matching an email address.
- The flow then loops through the CalendlyRoutingFormQuestionsAnswers records related to the CalendlyRoutingFormSubmission until it finds an email question. This will be the email address the flow uses to look for a matching record and if the flow can't find one, this will be the new lead's email.
- If the flow can't find an email, it ends since the flow won't create a Lead by default without an email address.
- If the flow finds an email:
- It looks for a contact that matches the email address.
- If the flow finds a contact, it associates the form submission to the contact by updating the Calendly Contact field on the CalendlyRoutingFormSubmission record to the Lead ID
- If the flow does not find a contact, it creates a new lead that will be owned by an active system admin.
- The flow then associates the form submission to the lead by updating the Calendly Lead field on the CalendlyRoutingFormSubmission record to the Lead ID.
Advanced options for routed events in Salesforce
Use FormSubmissionsUUID to identify routed events
The FormSubmissionsUUID field is on the CalendlyAction object. While this custom object and flow only trigger for Calendly-hosted forms (not those integrated with Pardot, Marketo, or HubSpot), we still pass a value to this field if the event was scheduled after completing a form that followed a Calendly routing rule.
This lets you customize the CreateEventTemplate flow to treat events from a form differently than those booked directly via a Calendly link by checking if this field is null.
Pass a Salesforce ID in your routing form link
To use a Salesforce ID in a routing form submission for looking up existing records, append "?salesforce_uuid=<ID>" to the end of your routing form link. This will store the Salesforce ID in the SalesforceId field on the CalendlyRoutingFormSubmission record.
For example: https://calendly.com/your_form?salesforce_uuid=123abc