Skip to main content
API docs by Redocly

Contacthub API (1.300.0)

Download OpenAPI specification:Download

API Support: contacthub@contactlab.com URL: http://www.contactlab.com License: Contactlab SPA

The Contacthub API allows you to collect, store, update and export the digital data of your customers.

Json Schemas of all entities and payloads.

Analytics

Analytics and stats endpoints.

Number of customer events by category

Counts the number of events aggregated by category for a customer. The default date range is the last year and the default resolution mode is DAILY.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

customerId
required
string <uuid>

The unique identifier of the customer.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

mode
string
Enum: "DAILY" "WEEKLY" "MONTHLY"

The distribution mode. limitation date range:

  • DAILY -> 1 year
  • WEEKLY -> 5 years
  • MONTHLY -> 10 years the system automatically changes the start parameter if it exceeds the limit.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Customer buying behaviors

Gets the customer buying behavior counters. The default date range is the last year.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

customerId
required
string <uuid>

The unique identifier of the customer.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Workspace information and total number of customers

Gets workspace information and total number of customers

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "status": "string",
  • "customers": 0
}

Nodes information and total number of customers

Gets nodes information and total number of customers

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ],
  • "page": {
    }
}

Number of customers

Counts the total number of customers.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": {
    }
}

Number of customers by creation date

Counts the number of customers aggregate by registeredAt. The default date range is the last year and the default resolution mode is MONTHLY.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

mode
string
Enum: "DAILY" "WEEKLY" "MONTHLY"

The distribution mode. limitation date range:

  • DAILY -> 1 year
  • WEEKLY -> 5 years
  • MONTHLY -> 10 years the system automatically changes the start parameter if it exceeds the limit.
nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Number of customers by available communication channels

Counts the number of customers by the available communication channels: email and mobile, email only, mobile only, not reachable.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": {
    }
}

Number of customers by update date

New customers added/changed/deleted in the date range. The default date range is the last month, and the max date range is 1 year for (1 month for deleted customers)

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

type
string
Default: "ADDED"
Enum: "ADDED" "UPDATED" "DELETED"

Specifies the type of aggregation (ADDED, UPDATED, DELETED).

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Number of events by update date

New events added/changed/deleted in the date range. The default date range is the last month, and the max date range is 1 year (1 month for deleted events).

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

type
string
Default: "ADDED"
Enum: "ADDED" "UPDATED" "DELETED"

Specifies the type of aggregation (ADDED, UPDATED, DELETED).

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Number of events by type and context

Events in the date range aggregated by type and context. Field 'date' of the event is used to filtered and aggregate events. The default date range is the last month, and the max date range is 1 year.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

context
string
Default: "ALL"
Enum: "WEB" "MOBILE" "ECOMMERCE" "RETAIL" "SOCIAL" "DIGITAL_CAMPAIGN" "CONTACT_CENTER" "IOT" "OTHER" "ALL"

Specifies the context.

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Events Kpi Purchases

Events Kpi Purchases. Field 'date' of the event is used to filtered and aggregate events. The default date range is the last month.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

type
string
Default: "ALL"
Enum: "ECOMMERCE" "RETAIL" "ALL"

Specifies kpi purchases type.

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Events Kpi Ecommerce

Events Kpi Ecommerce. Field 'date' of the event is used to filtered and aggregate events. The default date range is the last month.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Events Kpi Web

Events Kpi Web. Field 'date' of the event is used to filtered and aggregate events. The default date range is the last month.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
start
string <date-time>

Start date.

end
string <date-time>

End date.

nodeId
string <uuid>

Filter the entities belonging to this node id.

Responses

Response samples

Content type
application/json
{
  • "parameters": {
    },
  • "data": [
    ]
}

Bulk-jobs

Bulk-jobs endpoints.

Get bulk jobs per node

Gets the list of bulk jobs filtered by node id. Can also be filtered by status and entity type.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

query Parameters
status
string (BulkJobStatus)
Enum: "LOADED" "SCHEDULED" "PROCESSING" "STOPPED" "PROCESSED" "FAILED"
Example: status=LOADED

Job status to search for

entity
string (BulkJobEntity)
Enum: "CUSTOMER" "EVENT"
Example: entity=CUSTOMER

Job entity type to search for

size
integer

Size of the response.

sort
string

Sorting of the response.

page
integer

Page of the response.

Responses

Response samples

Content type
application/json
{
  • "page": {
    },
  • "elements": [
    ]
}

Create a bulk job

Creates new bulk job resource and uploads the input file from which the bulk job will retrieve the data. The job status will be LOADED or FAILED based on the result of the file upload. A maximum of 10 jobs with status LOADED can exist for each node.

Please note that entities are not guaranteed to be created in the same order as they are in the file.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Request Body schema: multipart/form-data
file
required
string <binary>

CSV file data.

operation
required
string (BulkJobOperation)
Enum: "UPSERT" "INSERT" "DELETE"

The bulk job operation mode.

entity
string (BulkJobEntity)
Enum: "CUSTOMER" "EVENT"

The entity type of the bulk job.

eventType
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

Type of the target event/s (immutable).

Responses

Request samples

Content type
multipart/form-data
externalId,base.firstName,base.contacts.email
100,John,Doe@example.com

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "filename": "string",
  • "operation": "UPSERT",
  • "workspaceId": "string",
  • "nodeId": "string",
  • "entity": "CUSTOMER",
  • "eventType": "abandonedCart",
  • "bulkJobName": "string",
  • "status": "LOADED",
  • "errorMessage": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "processedEntities": 0,
  • "failedEntities": 0,
  • "totalEntities": 0
}

Get a single bulk job

Gets a bulk job by id.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

jobId
required
string <uuid>

The unique identifier of the job

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "filename": "string",
  • "operation": "UPSERT",
  • "workspaceId": "string",
  • "nodeId": "string",
  • "entity": "CUSTOMER",
  • "eventType": "abandonedCart",
  • "bulkJobName": "string",
  • "status": "LOADED",
  • "errorMessage": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "processedEntities": 0,
  • "failedEntities": 0,
  • "totalEntities": 0
}

Get bulk job results

Gets bulk job results in .csv format; can be accessed only when a job is either PROCESSED or FAILED.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

jobId
required
string <uuid>

The unique identifier of the job

Responses

Configuration

Configuration endpoints.

Get workspace configuration

Gets the workspace configuration.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "industry": "GDO",
  • "logo": "http://example.com",
  • "timezone": "Europe/Rome",
  • "currency": "EUR",
  • "customerUniquenessPolicy": "MERGE",
  • "tier": null
}

Modify workspace configuration

Modifies the workspace configuration.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

Object necessary to modify the workspace configuration.

name
string

Name of workspace.

industry
string
Default: "NotDefined"
Enum: "GDO" "Luxury" "Automotive" "NotDefined"

Industry of workspace.

logo
string or null <uri>

Url of workspace logo.

timezone
string or null (Timezone)
Default: "Europe/Rome"
Enum: "Europe/Rome" "Europe/Paris" "Europe/London"

Default timezone of workspace.

currency
string
Default: "EUR"
Enum: "EUR" "USD" "JPY"

Default currency of workspace.

customerUniquenessPolicy
string or null
Default: "MERGE"
Value: "MERGE"

[Deprecated]: the only value accepted is MERGE

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "industry": "GDO",
  • "logo": "http://example.com",
  • "timezone": "Europe/Rome",
  • "currency": "EUR",
  • "customerUniquenessPolicy": "MERGE"
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "industry": "GDO",
  • "logo": "http://example.com",
  • "timezone": "Europe/Rome",
  • "currency": "EUR",
  • "customerUniquenessPolicy": "MERGE",
  • "tier": null
}

Get the workspace throttling

Gets the workspace throttling configuration. The value 0 (zero) means that throttling is disabled.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "maxRequestsPerMinute": 0
}

Modify the workspace throttling

Modifies the workspace throttling configuration. The value 0 (zero) means that throttling is disabled.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

Object necessary to modify the workspace throttling configuration.

maxRequestsPerMinute
integer >= 0

max requests per minute for workspace.

Responses

Request samples

Content type
application/json
{
  • "maxRequestsPerMinute": 0
}

Response samples

Content type
application/json
{
  • "maxRequestsPerMinute": 0
}

List event configurations

Gets the list of the built-in event configurations.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
resolveReferences
boolean

Whether to resolve references or not.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ],
  • "page": {
    }
}

Get event configuration

Gets the details of a built-in event.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

query Parameters
resolveReferences
boolean

Whether to resolve references or not.

Responses

Response samples

Content type
application/json
{
  • "id": "abandonedCart",
  • "type": "abandonedCart",
  • "mode": "ACTIVE",
  • "label": "string",
  • "description": "string",
  • "propertiesSchema": { },
  • "enabled": true
}

Modify event configuration

Enables or disables a built-in event. This endpoint is deprecated. Please use /workspaces/{workspaceId}/configuration/events/{eventType}/enabled.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

query Parameters
resolveReferences
boolean

Whether to resolve references or not.

Request Body schema: application/json
required

Event object for enable or disable.

id
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

Type of the target event/s (immutable).

type
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

Type of the target event/s (immutable).

enabled
boolean
Default: true

Flag for enable-disable event.

Responses

Request samples

Content type
application/json
{
  • "id": "abandonedCart",
  • "type": "abandonedCart",
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "id": "abandonedCart",
  • "type": "abandonedCart",
  • "mode": "ACTIVE",
  • "label": "string",
  • "description": "string",
  • "propertiesSchema": { },
  • "enabled": true
}

Get event properties

Gets the event type properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

query Parameters
resolveReferences
boolean

Whether to resolve references or not.

Responses

Response samples

Content type
application/json
{ }

Get event extended properties

Gets the event type extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify event extended properties

Modifies an event type extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

Request Body schema: application/json
required

The json schema that defines the extended profile.

Each json schema property can include the following custom property: label, enabled, indexed and mergePolicy.

Property indexed can only be changed by users with role CLAB_OPERATOR.

In property names it is not possible to use "." (e.g. "my.property")

additional property
(object or object or object or object) or (object or object) or (object or object) or (object or object)
One of
One of
type
required
string
Enum: "number" "integer" "boolean"
object

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify event state

Enables or disables a built-in event type.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

eventType
required
string (EventType)
Enum: "abandonedCart" "abandonedSession" "addedCompare" "addedProduct" "addedReward" "addedWishlist" "campaignBlacklisted" "campaignBounced" "campaignLinkClicked" "campaignMarkedSpam" "campaignOpened" "campaignOptinRequested" "campaignSent" "campaignSubscribed" "campaignUnsubscribed" "changedSetting" "clickedLink" "closedTicket" "completedOrder" "eventConfirmed" "eventDeclined" "eventEligible" "eventInvited" "eventNoShow" "eventNotInvited" "eventParticipated" "eventRegistered" "formCompiled" "genericActiveEvent" "genericPassiveEvent" "grantedCoupon" "loggedIn" "loggedOut" "openedTicket" "orderShipped" "removedCompare" "removedProduct" "removedReward" "removedWishlist" "repliedTicket" "reviewedProduct" "searched" "serviceSubscribed" "serviceUnsubscribed" "surveyCompiled" "viewedPage" "viewedProduct" "viewedProductCategory"

The name of event type.

Request Body schema: application/json
required

The value of the state.

value
boolean

True to enable the property, False to disable the property.

Responses

Request samples

Content type
application/json
{
  • "value": true
}

Response samples

Content type
application/json
{
  • "value": true
}

Get event types

Gets configured event types of a workspace.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "id": "abandonedCart",
  • "mode": "ACTIVE",
  • "enabled": true
}

Get configured event types for products update policy

Gets configured event types that updates products registry

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "eventTypes": [
    ]
}

Modify configured event types for products update policy

Modifies configured event types that updates products registry

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

list of event types.

eventTypes
Array of strings or null (ProductAwareEventType)
Enum: "completedOrder" "abandonedCart" "addedCompare" "addedProduct" "addedWishlist" "removedCompare" "removedProduct" "removedWishlist" "viewedProduct" "reviewedProduct"

set of event types

Responses

Request samples

Content type
application/json
{
  • "eventTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "eventTypes": [
    ]
}

Get plan model

Gets the available custom fields and the extended properties of the given plan model.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

planModel
required
string (PlanModel)
Enum: "ABANDONED_CART" "ATTENDANCE_EVENT" "COUPON" "ORDER" "ORDER_LINE" "PRODUCT_INTERACTION" "SERVICE_SUBSCRIBED" "SERVICE_UNSUBSCRIBED" "WEB_BROWSING_EVENT"

The model of event which is exported to plan.

Responses

Response samples

Content type
application/json
{
  • "plan": [
    ],
  • "hub": {
    }
}

Get product extended properties

Gets the product extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify product extended properties

Modifies the product extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The json schema that defines the extended profile.

Each json schema property can include the following custom property: label, enabled, indexed and mergePolicy.

Property indexed can only be changed by users with role CLAB_OPERATOR.

In property names it is not possible to use "." (e.g. "my.property")

additional property
(object or object or object or object) or (object or object) or (object or object) or (object or object)
One of
One of
type
required
string
Enum: "number" "integer" "boolean"
object

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get workspace retention policy status

Gets the retention policy status for a workspace.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
{
  • "property1": {
    },
  • "property2": {
    }
}

Get workspace retention policy

Gets the retention policy for each built-in event of a specific workspace.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify workspace retention policy

Configures the retention policy for each built-in event of a specific workspace.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The retention policy for each built-in event.

additional property
object (EventRetentionPolicy)
months
integer >= 0

Retention time in months.

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get workspace events consent policy

Gets the workspace events consent policy.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "property1": [
    ],
  • "property2": [
    ]
}

Modify workspace events consent policy

Modifies the workspace events consent policy.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The consent policy for each built-in event.

property name*
additional property
Array of strings

Type of event which the consent policy is added to.

Responses

Request samples

Content type
application/json
{
  • "property1": [
    ],
  • "property2": [
    ]
}

Response samples

Content type
application/json
{
  • "property1": [
    ],
  • "property2": [
    ]
}

Get workspace events payload size

Gets the workspace events payload size.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify workspace events payload size

Modifies the workspace events payload size.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The payload size for each built-in event.

additional property
object
maxBytes
integer [ 65535 .. 380928 ]

Max payload size in bytes.

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

List nodes

Gets a paged list of the nodes.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
page
integer [ 0 .. 50 ]
Default: 0

Paging: the page number.

size
integer [ 0 .. 50 ]
Default: 20

Paging: the page size.

nodeType
string
Enum: "ENTRY" "AGGREGATE"

The type of the node.

Responses

Response samples

Content type
application/json
{
  • "page": {
    },
  • "elements": [
    ]
}

Get node retention policy

Gets the retention policy for each built-in event of a specific node (entry or aggregate).

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the node (entry or aggregate).

Responses

Response samples

Content type
application/json
{
  • "enabled": true,
  • "events": {
    }
}

Modify node retention policy

Configures the retention policy for each built-in event for a specific node (entry or aggregate).

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of entry node (entry or aggregate).

Request Body schema: application/json
required

The retention policy for each built-in event.

enabled
boolean

Events retention policy state.

object (RetentionPolicyByEvent)

a map by event id of the retention status for every event of the workspace

EXAMPLE

  {
    "campaignSent": {
      "months": 6
    },
    "addedReward": {
      "months": 12
    }
  }

Responses

Request samples

Content type
application/json
{
  • "enabled": true,
  • "events": {
    }
}

Response samples

Content type
application/json
{
  • "enabled": true,
  • "events": {
    }
}

List entry nodes

Gets a paged list of the entries node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
page
integer [ 0 .. 50 ]
Default: 0

Paging: the page number.

size
integer [ 0 .. 50 ]
Default: 20

Paging: the page size.

Responses

Response samples

Content type
application/json
{
  • "page": {
    },
  • "elements": [
    ]
}

Create entry node

Creates a new entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The entry node object.

name
required
string

The name of entry node.

description
string or null

The description of entry node.

imageUrl
string or null <uri>

The url of logo.

object (UniqueCustomer)
sourcePriority
Array of strings <uuid> [ items <uuid > ]

Array of source id

mandatoryProperties
Array of strings

Array of mandatory properties.

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "http://example.com",
  • "uniqueCustomer": {
    },
  • "sourcePriority": [
    ],
  • "mandatoryProperties": [
    ]
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "http://example.com",
  • "uniqueCustomer": {
    },
  • "sourcePriority": [
    ],
  • "mandatoryProperties": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Get entry node

Gets the details of a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "http://example.com",
  • "uniqueCustomer": {
    },
  • "sourcePriority": [
    ],
  • "mandatoryProperties": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Modify entry node

Modifies a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Request Body schema: application/json
required

The entry node object.

id
required
string <uuid>

The identifier of entry node.

name
required
string

The name of entry node.

description
string or null

The description of entry node.

imageUrl
string or null <uri>

The url of logo.

required
object (UniqueCustomer)
sourcePriority
Array of strings <uuid> [ items <uuid > ]

Array of source id

mandatoryProperties
Array of strings

Array of mandatory properties.

Responses

Request samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "description": "string",
  • "imageUrl": "http://example.com",
  • "uniqueCustomer": {
    },
  • "sourcePriority": [
    ],
  • "mandatoryProperties": [
    ]
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "http://example.com",
  • "uniqueCustomer": {
    },
  • "sourcePriority": [
    ],
  • "mandatoryProperties": [
    ],
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Delete entry node

Deletes a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Responses

Empty entry node

Removes all the data in a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

query Parameters
eventsOnly
boolean

Empty events only.

Responses

Get entry node retention policy

Gets the retention policy for each built-in event of a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify entry node retention policy

Configures the retention policy for each built-in event of a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Request Body schema: application/json
required

The retention policy for each built-in event.

additional property
object (EventRetentionPolicy)
months
integer >= 0

Retention time in months.

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Get entry node retention policy state

Gets the retention policy state for a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Responses

Response samples

Content type
application/json
{
  • "enabled": true
}

Modify entry node retention policy state

Configures the retention policy state for a specific entry node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the entry node.

Request Body schema: application/json
required

The retention policy state.

enabled
boolean

Events retention policy state.

Responses

Request samples

Content type
application/json
{
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "enabled": true
}

List aggregate nodes

Gets the list of the aggregate nodes.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ],
  • "page": {
    }
}

Create aggregate node

Creates a new aggregate node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The aggregate node object.

name
string

The name of aggregate node.

description
string or null

The description of aggregate node.

imageUrl
string or null

The url of the logo.

entryNodes
Array of strings <uuid> non-empty [ items <uuid > ]
object
Array of objects or null

Exclusion filters can be applied on the aggregate node to exclude customers and associated events (max 10 filters).

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "string",
  • "entryNodes": [
    ],
  • "matchingProperties": {
    },
  • "exclusionFilters": [
    ]
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "string",
  • "entryNodes": [
    ],
  • "matchingProperties": {
    },
  • "exclusionFilters": [
    ],
  • "state": "ACTIVE",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Get aggregate node

Gets the details of a specific aggregate node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

aggregateNodeId
required
string <uuid>

The unique identifier of the aggregate node.

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "string",
  • "entryNodes": [
    ],
  • "matchingProperties": {
    },
  • "exclusionFilters": [
    ],
  • "state": "ACTIVE",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Modify aggregate node

Modifies an aggregate node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

aggregateNodeId
required
string <uuid>

The unique identifier of the aggregate node.

Request Body schema: application/json
required

The aggregate node object. The properties entryNodes and matchingProperties cannot be changed.

name
string

The name of aggregate node.

description
string or null

The description of aggregate node.

imageUrl
string or null

The url of the logo.

entryNodes
Array of strings <uuid> non-empty [ items <uuid > ]
object
Array of objects or null

Exclusion filters can be applied on the aggregate node to exclude customers and associated events (max 10 filters).

state
string
Enum: "ACTIVE" "NEW" "LOCKED" "REMOVED"

State of aggregate node.

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "string",
  • "entryNodes": [
    ],
  • "matchingProperties": {
    },
  • "exclusionFilters": [
    ],
  • "state": "ACTIVE"
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "imageUrl": "string",
  • "entryNodes": [
    ],
  • "matchingProperties": {
    },
  • "exclusionFilters": [
    ],
  • "state": "ACTIVE",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Delete aggregate node

Deletes an aggregate node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

aggregateNodeId
required
string <uuid>

The unique identifier of the aggregate node.

Responses

Modify aggregate node state

Changes the state of an aggregate node. Currently the only supported transition is from NEW to ACTIVE.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

aggregateNodeId
required
string <uuid>

The unique identifier of the aggregate node.

Request Body schema: application/json
required

The aggregate node state.

state
string
Enum: "ACTIVE" "NEW" "LOCKED" "REMOVED"

State of aggregate node.

Responses

Request samples

Content type
application/json
{
  • "state": "ACTIVE"
}

Response samples

Content type
application/json
{
  • "state": "ACTIVE"
}

List aggregate node send source subscriptions

Gets all the send source subscriptions of an aggregate node.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

aggregateNodeId
required
string <uuid>

The unique identifier of the aggregate node.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get customer base properties

Gets all the customer base properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ]
}

Modify customer base property state

Enables or disables a customer base property.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

name
required
string

The name of the customer base property.

Request Body schema: application/json
required

The object to enable or disable the property.

name
string

The json path of the base property.

description
string

The description of base property.

enabled
boolean

Flag for enable/disable the base property.

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "description": "string",
  • "enabled": true
}

Get customer extended properties

Gets customer extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Modify customer extended properties

Modifies customer extended properties.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The json schema that defines the extended profile.

Each json schema property can include the following custom property: label, enabled, indexed, and mergePolicy. For properties of type String, the property maxLength is required; the default value (i.e. if no other value is passed) is 255 for scalar properties, 1000 for String array properties (in this case, the maxLength property refers to the sum of the lengths of strings in the array plus length of separators)

MaxLength property must be between 1 and 6000

Property indexed can only be changed by users with role CLAB_OPERATOR.

In property names it is not possible to use "." (e.g. "my.property")

additional property
(object or object or object or object) or (object or object) or (object or object) or (object or object)
One of
One of
type
required
string
Enum: "number" "integer" "boolean"
object

Responses

Request samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

Response samples

Content type
application/json
{
  • "property1": {
    },
  • "property2": {
    }
}

List sources

Gets the workspace source list.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ],
  • "page": {
    }
}

Create source

Creates a new source. Only CLAB_OPERATOR and ADMIN roles are allowed to create a Send source. Please note that sources with the following providers can no longer be created (Javascript, MAGENTO, ANDROID_SDK, OBJECTIVEC_SDK, NODEJS_SDK, JAVA_SDK, SCALA_SDK, DOTNET_SDK)

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Request Body schema: application/json
required

The source configuration object.

One of
provider
string
Value: "API"

The provider of the source.

object
name
string

The name of source.

description
string or null

The description of source.

nodes
Array of strings <uuid> non-empty [ items <uuid > ]

List of unique identifier where source is enabled.

enabled
boolean
Default: true

Flag for enable-disable source.

Responses

Request samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true
}

Response samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "token": "string"
}

Get source

Gets a source details.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

sourceId
required
string <uuid>

The unique identifier of the source.

Responses

Response samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "token": "string"
}

Modify source

Modifies a source. Only CLAB_OPERATOR and ADMIN roles are allowed to modify a Send source.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

sourceId
required
string <uuid>

The unique identifier of the source.

Request Body schema: application/json
required

The source configuration object.

One of
provider
string
Default: "API"
Enum: "API" "MAGENTO" "ANDROID_SDK" "OBJECTIVEC_SDK" "NODEJS_SDK" "JAVA_SDK" "SCALA_SDK" "DOTNET_SDK"

The provider of the source.

object
name
string

The name of source.

description
string or null

The description of source.

nodes
Array of strings <uuid> non-empty [ items <uuid > ]

List of unique identifier where source is enabled.

enabled
boolean
Default: true

Flag for enable-disable source.

id
string <uuid>

Unique identifier of source.

Responses

Request samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Response samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "token": "string"
}

Delete source

Deletes a source.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

sourceId
required
string <uuid>

The unique identifier of the source.

Responses

Refresh source token

Refreshes the source token.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

sourceId
required
string <uuid>

The unique identifier of the source.

Responses

Response samples

Content type
application/json
{
  • "provider": "CONTACTPLAN",
  • "properties": {
    },
  • "name": "string",
  • "description": "string",
  • "nodes": [
    ],
  • "enabled": true,
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "token": "string"
}

Get default customer matching policy

Gets the default unique customer matching policies.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

Responses

Response samples

Content type
application/json
{
  • "properties": [
    ],
  • "caseSensitive": true
}

Get customer matching policy

Gets the node unique customer matching policies. This route is deprecated, please use GET on /workspaces/{workspaceId}/configuration/nodes/entries/{nodeId}

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the node.

Responses

Response samples

Content type
application/json
{
  • "properties": [
    ],
  • "caseSensitive": true
}

Modify customer matching policy

Updates the unique customer matching policies for the aggregation on the selected node. This route is deprecated, please use PUT on /workspaces/{workspaceId}/configuration/nodes/entries/{nodeId}

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

nodeId
required
string <uuid>

The unique identifier of the node.

Request Body schema: application/json
required

The matching policy configuration for the selected node.

properties
Array of strings non-empty

Rules of aggregations.

caseSensitive
boolean

Flag that specifies if the matching policy check will be performed considering the field text case.

Responses

Request samples

Content type
application/json
{
  • "properties": [
    ],
  • "caseSensitive": true
}

Response samples

Content type
application/json
{
  • "properties": [
    ],
  • "caseSensitive": true
}

List users

Gets the users paginated list.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
search
string

Term to filter results based on a specific pattern contained in the name, surname, username or email.

Responses

Response samples

Content type
application/json
{
  • "elements": [
    ],
  • "page": {
    }
}

Get user

Gets a user details.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

id
required
integer

The unique identifier of the user.

Responses

Response samples

Content type
application/json
{
  • "id": 229,
  • "name": "Claire",
  • "registeredAt": null,
  • "updatedAt": null,
  • "nodes": [
    ]
}

Modify user

Modify user nodes.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

id
required
string <uuid>

The unique identifier of the user.

Request Body schema: application/json
required

The user configuration object.

required
Array of objects
Array
id
string <uuid>

Unique identifier of the node.

permission
string
Default: "R"
Enum: "R" "RW" "W"

Permission mode.

Responses

Request samples

Content type
application/json
{
  • "nodes": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 229,
  • "name": "Claire",
  • "registeredAt": null,
  • "updatedAt": null,
  • "nodes": [
    ]
}

Get customer properties

Gets the customer json schema with references resolved if the relative parameter is true

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
resolveReferences
boolean

Whether to resolve references or not.

Responses

Response samples

Content type
application/json
{ }

Modify customer base property state

Enables or disables a customer base property.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

baseProperty
required
string

The base property to toggle.

Request Body schema: application/json
required

The value of the flag.

value
boolean

True to enable the property, False to disable the property.

Responses

Request samples

Content type
application/json
{
  • "value": true
}

Response samples

Content type
application/json
{
  • "value": true
}

Consents

Consent endpoints.

Get consent

Gets an operation on consents.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

id
required
string

Identifier of the consent log.

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "customerId": "87d8e330-2878-4742-a86f-dbbb3bf522ac",
  • "date": "2019-08-24T14:15:22Z",
  • "type": "DISCLAIMER_READ",
  • "property": "string",
  • "value": "string",
  • "sourceId": "797f5a94-3689-4ac8-82fd-d749511ea2b2",
  • "userId": 0
}

List consents

Gets list of operations on consents.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
customerId
string

Identifier of the customer.

uniqueKey
string

The json structured data containing the values of the unique customer property

startDate
string <date>

The date interval lower bound.

endDate
string <date>

The date interval upper bound.

type
string (ConsentEventType)
Enum: "DISCLAIMER_READ" "CONSENT_CHANGED" "CONSENT_RESTRICTED" "CONSENT_OBJECTED" "DATA_PORTABILITY_REQUESTED" "FORCED_DELETE"

The type of consent log event.

property
string

Json path of property.

sort
string

Sort field and direction.

nodes
string

Comma separated node ids.

Responses

Response samples

Content type
{
  • "elements": [
    ],
  • "page": {
    }
}

Customers

Customers endpoints.

Search customers

Searches customers using the provided query parameters.

The matched items are paged and sorted (by descending update date as default).

The maximum number of matched elements is 10000.

Authorizations:
OAuth2
path Parameters
workspaceId
required
string <uuid>

The unique identifier of the workspace.

query Parameters
nodeId
required
string <uuid>

The nodeId of the customer.

externalId
string

The externalId of the customer.

query
string

Complex query filter.

fields
string

Comma-separated list of properties to include in the response.

size
integer

Size of the response.

sort
string

Sorting of the response.

page
integer

Page of the response.

Responses

Response samples

Content type
application/json
{
  • "elements": [