How To Request & Write Raw Integration Data

February 6, 2024

Reading data

While Unified.to abstracts all of the integration's objects into common objects, you can still request that the original object.

Simply include a fields=raw parameter in your request.

GET /crm/123456789/contacts?fields=raw

The result will also include a field named raw that will contain the original vendor's object. You can add more field names in there as well (comma-delimited) and only those fields will be returned.

Writing data

Simply include a raw field in the payload with the integration's specific fields.

POST /crm/123456789/contacts

{
    "name": "Joe Smith",
    "raw": {
        "customfield1":"Blue",
        "customfield2":"Bananas"
    }
}

Those fields in the raw object can also overwrite any mapped unified fields.

Passing Raw Parameters

Some providers support extra filters or options that Unified doesn't standardize.

You can pass them using the raw query parameter.

Take normal query params like:

status=active&limit=10

Encode them into:

GET /crm/123456789/contact?raw=status%3Dactive%26limit%3D10