Mapping HubSpot Properties to Webhook Payload

For Body (POST, PUT, PATCH methods):

1. In the Body Configuration section, use HubSpot property syntax: {{object.property}}

2. Nest properties within your JSON structure as needed

Example:

{
  "contact": {
    "firstName": "{{contact.firstname}}",
    "lastName": "{{contact.lastname}}",
    "email": "{{contact.email}}"
  },
  "deal": {
    "amount": "{{deal.amount}}",
    "stage": "{{deal.dealstage}}"
  }
}

For Query Parameters (GET, DELETE methods):

1. In the Query Parameters section, set key-value pairs

2. Use HubSpot property syntax for dynamic values

Example:

• Key: contactId, Value: {{contact.id}}

• Key: dealAmount, Value: {{deal.amount}}

Result: ?contactId=123456&dealAmount=10000

Configuring Dynamic Content Insertion

Using Conditional Logic

Use HubSpot's syntax for conditional insertions:

{% if contact.company %}

  "company": "{{contact.company}}"

{% else %}

  "company": "Individual"

{% endif %}

Formatting Date and Number Properties

Use HubSpot's filters to format properties:

• Date: {{deal.closedate|date:"yyyy-MM-dd"}}

• Number: {{deal.amount|number:"0.00"}}

Handling List Properties

For properties that return lists, use indexing:

{
  "primaryContact": "{{company.contacts.name[0]}}",
  "allContacts": [
    {% for contact in company.contacts %}
      "{{contact.name}}"{% if not forloop.last %},{% endif %}
    {% endfor %}
  ]
}

Best Practice

Test your data mapping thoroughly using HubSpot's workflow testing feature with various sample records to ensure all scenarios are handled correctly.