Route enquiries to the right dealer by postcode

When you send a submission from Customer.io, the enquiry can be assigned to a specific dealer location. You have two ways to do this: send the location yourself, or let Vyro work it out from the customer's postcode. Postcode routing lets you retire any dealer-allocation logic you currently maintain in Customer.io.

Both options need your form to have a dealer-location field. Your Account Manager or a dashboard admin sets this up on the form once.

Option 1 — Send the location yourself (manual)

If you already know which dealer an enquiry belongs to, include the dealer's location ID as one of your values, using your form's dealer-location field name:

{
  "form_id": "your-vyro-form-id",
  "showroom_code": "your-showroom-code",
  "values": {
    "email": "jordan@example.com",
    "location_id": "the-dealer-location-id"
  }
}

Vyro assigns the enquiry to that location. This is the right choice when Customer.io already decides the dealer.

Option 2 — Let Vyro resolve it from the postcode

Instead of sending a location, send the customer's postcode and ask Vyro to match it to a dealer. Add a pma_lookup directive next to values:

{
  "form_id": "your-vyro-form-id",
  "showroom_code": "your-showroom-code",
  "values": {
    "email": "jordan@example.com",
    "postcode": "3000"
  },
  "pma_lookup": {
    "field": "postcode",
    "method": "postcode"
  }
}

field is the key in values that holds the postcode (here, postcode).
method is always postcode.

Vyro matches the postcode against each dealer's primary market area (the postcode list set on each location), scoped to your showroom, and assigns the enquiry to the matching dealer. This requires your showroom to use postcode-based primary market areas, with each dealer's postcodes configured in the dashboard.

What happens when no postcode matches

If the postcode doesn't fall inside any dealer's primary market area, Vyro assigns the enquiry to your showroom's configured fallback location so the lead is never lost. Set the fallback location in your showroom's primary market area settings.

Precedence

If you send both an explicit location and a pma_lookup, the explicit location wins — the lookup only runs when no location is supplied. This means you can add pma_lookup to all submissions safely and still override it for specific dealers when needed.

Result

Open the enquiry in your dashboard and confirm it's assigned to the expected dealer. If it landed on the fallback location unexpectedly, check that the customer's postcode is listed in the intended dealer's primary market area.