Formsort

Ingest your event data from Formsort into RudderStack.

  •   2 minute read  

Formsort platform provides tools for businesses and organizations to create user-friendly forms and surveys. You can use these forms for lead generation, customer feedback, event registration, job applications, etc.

Getting started

Follow these steps to set up your Formsort source in the RudderStack dashboard:

  1. Go to your RudderStack dashboard and click Add Source. From the list of Event Streams sources, select Formsort.
  2. Assign a name to your source and click Continue.
  3. Your Formsort source is now configured. Note the Webhook URL in the Settings tab:
Formsort source webhook URL
  1. Log in to your Formsort account.
  2. Set up your webhook integration, add the Webhook URL obtained in step 3, and save the configuration:
Formsort source webhook URL

Event transformation

Based on the webhook posting frequency you choose while setting up the webhook integration in Formsort, RudderStack sets the event name as FlowFinalized when the flow is finalized. Otherwise, it sets the event name as FlowLoaded.

RudderStack ingests the Formsort events after converting them into the RudderStack event format. It also maps the following properties from the Formsort event payload to the RudderStack properties:

Formsort propertyRudderStack property
created_atoriginalTimestamp
responder_uuiduserId
answersproperties
flow_labelcontext.page.title
variant_labelcontext.variantLabel
variant_uuidcontext.variantUuid

How RudderStack creates the event payload

This section details how RudderStack receives the data from Formsort source and creates the resulting payload.

FlowFinalized event

A sample payload sent by Formsort when finalized is true is shown below:

{
  "answers": {
    "yes": true,
    "enter_email": "testUser@rudderstack.com",
    "enter_name": "2000-11-25",
    "yes_or_no": false
  },
  "responder_uuid": "be2f3a8d-8aa4-4a01-8855-8e464a752b52",
  "flow_label": "new-flow-2022-11-25",
  "variant_label": "main",
  "variant_uuid": "0828efa7-7215-4e7d-a7ab-6c1079010cea",
  "finalized": true,
  "created_at": "2022-11-25T14:36:58+00:00"
}

RudderStack transforms the above payload into the following track payload with event name as FlowFinalized:

{
  "context": {
    "library": {
      "name": "unknown",
      "version": "unknown"
    },
    "integration": {
      "name": "Formsort"
    },
    "page": {
      "title": "new-flow-2022-11-25"
    },
    "variantLabel": "main",
    "variantUuid": "0828efa7-7215-4e7d-a7ab-6c1079010cea"
  },
  "integrations": {
    "Formsort": false
  },
  "type": "track",
  "anonymousId": "7bd86cd0-df65-4e3e-bddd-3ba4da17fbb3",
  "userId": "be2f3a8d-8aa4-4a01-8855-8e464a752b52",
  "originalTimestamp": "2022-11-25T14:36:58+00:00",
  "properties": {
    "yes": true,
    "enter_email": "testUser@rudderstack.com",
    "enter_name": "2000-11-25",
    "yes_or_no": false
  },
  "event": "FlowFinalized"
}

FlowLoaded event

A sample payload sent by Formsort when finalized is false is shown below:

{
  "answers": {
    "yes": true,
    "enter_email": "test@user.com",
    "enter_name": "2022-11-17",
    "yes_or_no": false
  },
  "responder_uuid": "66a8e5bb-67e1-47ec-b55f-a26fd4be2dc7",
  "flow_label": "new-flow-2022-11-25",
  "variant_label": "main",
  "variant_uuid": "0828efa7-7215-4e7d-a7ab-6c1079010cea",
  "finalized": false,
  "created_at": "2022-11-25T14:41:22+00:00"
}

RudderStack transforms the above payload into the following track payload with event name as FlowLoaded:

{
  "context": {
    "library": {
      "name": "unknown",
      "version": "unknown"
    },
    "integration": {
      "name": "Formsort"
    },
    "page": {
      "title": "new-flow-2022-11-25"
    },
    "variantLabel": "main",
    "variantUuid": "0828efa7-7215-4e7d-a7ab-6c1079010cea"
  },
  "integrations": {
    "Formsort": false
  },
  "type": "track",
  "anonymousId": "448a42fd-18e5-4cdf-859b-5b99aceaf474",
  "userId": "be2f3a8d-8aa4-4a01-8855-8e464a752b52",
  "originalTimestamp": "2022-11-25T14:36:58+00:00",
  "properties": {
    "yes": true,
    "enter_email": "testUser@rudderstack.com",
    "enter_name": "2000-11-25",
    "yes_or_no": false
  },
  "event": "FlowLoaded"
}

Questions? Contact us by email or on Slack