LogoLogo
Back to studio
  • Formsort documentation
  • ⏩Quickstart
    • 🟒Get started with Formsort
    • 🍎Core concepts
    • ℹ️Question and content reference
    • πŸ“•Key terms
    • 🏞️Create your first flow
    • πŸ“–Add content and collect answers
      • 🀳Capture demographic data
      • ℹ️Add informational content
      • πŸ” Review your variable schema
    • 🎨Create a theme
      • Set brand guidelines
    • 🀹Personalize your flow
      • 🌟Template your variables
      • 🧠Add conditional logic
      • πŸ’«Using conditional logic with Calculated and API variables
      • πŸ”šEnd the flow
    • πŸ”€Set up integrations
    • πŸš€Go live
      • Auditing your flow for content, functionality, and design
    • πŸ’ΌCommon use cases
      • πŸ’”Disqualify responders
      • πŸ—“οΈAdd a scheduling option
      • πŸ“„Allow responders to read and accept your company policies
  • πŸ—οΈBuilding flows
    • Flows and variants
      • Flow starts
    • Adding content
      • Groups
      • Steps
        • Settings
        • Logic
        • Style
      • Questions
        • General Settings
        • Style
        • Address
        • Comparison
        • Confirmation
        • Date
        • Date & Time
        • Email address
        • File upload
        • Grid choice
        • Iframe
        • Image upload
        • Number
        • Payment
        • Phone number
        • Postal code
        • Question group
        • Region
        • Select
          • Providing choices via API or calculation
        • Signature
        • SSN
        • Text questions
        • Yes/No
      • Content
        • General Settings
        • Statement
        • Image
        • Video
        • Next button
        • Divider
        • Map
      • Endings
      • Using markdown
      • Using variable templating
        • Template formatting functions
      • Copy-pasting form content
      • Content library
    • Conditions and logic
      • Logical operator reference
      • Advanced logic
    • Variables (answers)
      • Variables from questions
      • Externally provided variables
      • Calculated variables
      • API lookups
      • System Library variables
      • Orphaned variables
    • Schemas
      • JSON Schemas
      • Validating flow schemas
    • Redirects
    • Styling and themes
      • CSS Reference
      • Overriding theme styling
      • Custom CSS overrides
      • Content area
      • Animations and transitions
      • Form Layout
      • Typography
        • Adobe Fonts
        • Hosting custom fonts
      • Color variables
      • Dimension variables
      • Question containers
      • Assets
      • Form Buttons
        • Select buttons
      • Inputs and dropdowns
      • Checkmarks
      • Tables
      • Sliders
      • Divider lines
      • Progress bar
      • Comparison cards
    • Variant settings
      • Form behavior for returning responders
      • Group ranking API
    • Publishing and versions
      • Preview window
      • Deploying
      • History
  • πŸ’ΎHandling data
    • Philosophy and data retention policy
    • Viewing form answers
    • Responder UUIDs
    • Environments
      • Loading different environments
    • Passing data in
      • URL parameters
      • POST body
      • Embed query parameters
    • Custom validators
    • Form answers and events
      • Analytics events
      • Signed requests
      • Event payload shape
      • Submission frequencies
      • Runtime error reporting
      • Admin API
      • Flow content data format
    • Integration reference
      • Amplitude
        • Amplitude cross domain tracking
      • BigQuery
      • FullStory
      • Google Analytics
        • Updating from Universal Analytics to GA4
      • Google Cloud Storage
      • Google Sheets
      • Google Tag Manager (GTM)
        • JavaScript triggered by flow events
      • Hubspot
      • Jornaya
      • Optimizely
      • PostgreSQL
      • Redshift
      • Rudderstack
      • S3
      • Salesforce
      • Segment
        • Segment Setup
        • Segment cross domain tracking
      • Stripe
      • TrustedForm
      • Webhooks
        • Zapier
  • πŸ“ΊGoing live
    • Custom domains
    • Built-in analytics
    • Embedding
      • Web-Embed API
        • React-embed
      • Adding authentication
      • Embedding forms in iOS and Android
      • Setting up a dev environment
    • Split testing
    • Preflight checklist
  • 🏒Teams
    • Accounts
      • Roles and permissions
    • Events subscriptions
    • Workspace domain detection
Powered by GitBook
On this page
  • About the Salesforce Integration
  • Credential setup
  • Salesforce object setup
  • Field mapping setup

Was this helpful?

  1. Handling data
  2. Integration reference

Salesforce

Creating and updating Salesforce objects using Formsort forms

PreviousS3NextSegment

Last updated 1 year ago

Was this helpful?

Access to the Salesforce integration is invite-only during testing. Please ask in the chat to be invited if you would like to try it out.

About the Salesforce Integration

Formsort allows creating and updating any Salesforce object with form data.

Objects are given an external ID by Formsort, corresponding to the responder UUID. When a form is filled out, if an object with the responder's responderUUID does not yet exist, it will be created. Otherwise, the existing object will be updated.

Credential setup

  1. First, go to Integrations > Salesforce at the flow level

  2. Click Add destination and Add a credential...

  3. Enter your Salesforce username, password, and security token (which can be found in your personal account settings). If you already have a security token, you'll have to click on 'Reset My Security Token' to get the token.

  4. Click Save credential

Salesforce object setup

For Formsort to know whether to create a new instance of an object, or to update an existing one, you (or an administrator of your Salesforce) will need to add an external field to your target object. This will store the formsort , and will be used as a key to perform upsert operations.

To create the external ID by which Formsort will reference an object

  1. Logs into their Salesforce

  2. Go to Setup

  3. Under Object Manager, click the Salesforce object that the integration will save to (example, β€˜Contact’)

  4. Go to Fields & Relationships

  5. Click New to a custom field with type β€˜text’

  6. In the next dialog, add the following and ensure that:

    1. Unique is checked

    2. External ID is checked

    3. Length is set to 200

    4. Field label is something identifiable as being managed by Formsort, such as β€˜formsort_responder_uuid’

Field mapping setup

Once a credential has been chosen, and you have modified your target object, you must set up how the integration will write data to Salesforce.

  1. Go to Integrations > Salesforce in your flow.

  2. Ensure the credential you have previously added is selected.

  3. Select a Posting frequency to determine how often data should be sent.

  4. Choose the object you previously set up in Salesforce Object Name

  5. Choose the external ID that was previously set up under External ID Field Name

    1. This field will store the responder UUID.

  6. Click Edit Mapping to determine how variables within Formsort will be mapped to fields within your target Salesforce object.

  7. Click Save at the top of the integration and re-deploy your flow for the changes to be picked up.

πŸ’Ύ
responder UUID
Formsort Salesforce mapping