Connect HubSpot

How HubSpot signs requests

A private app access token, sent as a bearer token in the Authorization header.

Can you connect it today?

Yes, with a private app. Add a bearer-token credential with its access token.

A sample mapping

Your application sends the first request below. The mapping turns it into the body of POST /crm/v3/objects/contacts, shown second.

{
    "email": "ana@example.com",
    "firstName": "Ana",
    "lastName": "Silva"
}

{
    "properties": {
        "email": "ana@example.com",
        "firstname": "Ana",
        "lastname": "Silva"
    }
}

The mapping

{
    "$schema": "https://schemas.echorelay.dev/transform/mapping/v1.json",
    "root": {
        "type": "object",
        "id": "root",
        "properties": {
            "properties": {
                "type": "object",
                "id": "props",
                "properties": {
                    "email": {
                        "type": "field",
                        "id": "email",
                        "path": "email"
                    },
                    "firstname": {
                        "type": "field",
                        "id": "first-name",
                        "path": "firstName"
                    },
                    "lastname": {
                        "type": "field",
                        "id": "last-name",
                        "path": "lastName"
                    }
                }
            }
        }
    }
}

The grammar, the answer mapping and the dry run are in the mapping docs.

What you bring

This is not a ready-made connector. You bring a sample request or HubSpot’s OpenAPI document, you or your agent write the mapping, and we run the integration you define.