Step 2: Configure Surface Workflow

Configure the Surface Workflow Builder to send a webhook to Customer.io whenever a lead submits your form, complete or partial.

Open the Workflow Builder

1. In the Surface app, open your form
2. Go to the Workflows section
3. Click Create Workflow (or edit an existing workflow)

Choose Your Triggers

Surface workflows support paths for different triggers, so you can handle both partial and completed submissions in one workflow:

Add both triggers to your workflow. Each path sends to a different Customer.io webhook URL (from Step 1), so the right event fires automatically. You do not need to pass submission_type in the payload.

Add the HTTP Request Action

For each trigger path (Dropped Off and Form Submission):

1. Click the + button to add a new node

2. Select HTTP Request from the actions menu

3. In the configuration panel, set:

   • Request URL:
     • Dropped Off path → Paste the webhook URL from your partial Customer.io campaign
     • Form Submission path → Paste the webhook URL from your completed Customer.io campaign
   • HTTP Method: POST
   • Body: Same payload for both paths (see below)

Build the Webhook Payload

Use the @ symbol in the workflow builder to insert form variables. Your payload should include:

• Identifier (email): required for Customer.io to create/update the person
• Any other fields you want to pass (name, form ID, etc.)

Use the same payload for both paths. The webhook URL determines which event fires in Customer.io.

Example payload:

{
  "email": "@email",
  "first_name": "@first_name",
  "last_name": "@last_name",
  "form_id": "@form_id",
  "submitted_at": "@submitted_at"
}

Activate the Workflow

1. Save the workflow
2. Activate it so it runs when leads submit your form
3. Test with a sample submission and verify the webhook reaches Customer.io

Verify in Customer.io

After a test submission:

1. Check Customer.io Campaigns → your webhook campaigns → Logs to see if the webhook was received
2. Check People to confirm the lead was created or updated
3. Check that the correct event was recorded (partialFormFilled for Dropped Off, formCompleted for Form Submission)

Next Step

Step 3: Event-Based Email Campaigns, the campaigns that run when these events fire.