Skip to main content

Drift

This Integration is part of the Drift Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

Drift integration to fetch, modify, create and delete contacts within the Drift Plattform's Contact API. This integration was integrated and tested with version 1.7 of Drift

Configure Drift on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Drift.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Access TokenAPI Access TokenTrue
    Use system proxy settingsFalse
    Trust any certificate (not secure)False
    Fetch indicatorsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

drift-get-contact#


Retrieve a contact using their email address (for multiple) or ID (for single).

Base Command#

drift-get-contact

Input#

Argument NameDescriptionRequired
idID of the contact (overrides the email input).Optional
emailEmail of the contact.Optional

Context Output#

PathTypeDescription
Drift.Contacts.idnumberID of the contact
Drift.Contacts.createdAtnumberCreated at timestamp (Epoch Unix Timestamp)
Drift.Contacts.AttributesunknownAttributes of the contact (JSON dict).

drift-update-contact#


Patch Contact Updates using contact ID

Base Command#

drift-update-contact

Input#

Argument NameDescriptionRequired
idContact ID.Required
attributesAttributes to be updates.Required

Context Output#

PathTypeDescription
Drift.Contacts.idnumberID of the created contact
Drift.Contacts.createdAtnumberCreated at timestamp (Epoch Unix Timestamp)
Drift.Contacts.attributesunknownAttributes of the contact (JSON dict).

drift-delete-contact#


Delete Contact using contact ID

Base Command#

drift-delete-contact

Input#

Argument NameDescriptionRequired
idContact ID.Required

Context Output#

There is no context output for this command.

drift-post-contact#


Post New Contact using a new contact Email

Base Command#

drift-post-contact

Input#

Argument NameDescriptionRequired
emailNew Contact Email.Required

Context Output#

PathTypeDescription
Drift.Contacts.idnumberID of the created contact
Drift.Contacts.createdAtnumberCreated at timestamp (Epoch Unix Timestamp)
Drift.Contacts.AttributesunknownAttributes of the contact (JSON dict).