Event Subscription

(API Version v8)

What can you do with EventSubscription?

DELETE EventSubscription/Email/{id}
Delete an instance of the EventSubscription object.
DELETE EventSubscription/Webhook/{id}
Delete an instance of the EventSubscription object.
PATCH EventSubscription/Email/{id}
Update or Add the EventSubscription object and optionally make changes to any child objects.
PATCH EventSubscription/Webhook/{id}
Update or Add the EventSubscription object and optionally make changes to any child objects.
POST EventSubscription/Email/
Create a new instance of the EventSubscription object.
POST EventSubscription/Webhook/
Create a new instance of the EventSubscription object.
PUT EventSubscription/Email/{id}
Update an existing instance of the EventSubscription object.
PUT EventSubscription/Webhook/{id}
Update an existing instance of the EventSubscription object.

Properties

Property Details

identity READ-ONLY	"identity": 22 Type: Number This is the unique numeric identifier for the EventSubscription
name	"name": "Hello World" Type: String
description	"description": "Hello World" Type: String
isActive	"isActive": true Type: Boolean
eventRegistrationId	"eventRegistrationId": 25 Type: Number Unique identifier for the associated EventRegistration object.
eventRegistrationName	"eventRegistrationName": "Sample Name" Type: String The name of the object associated with the eventRegistrationId property.
eventBindingActionId	"eventBindingActionId": 2 Type: Number Unique identifier for the associated EventBindingAction object.
eventBindingActionName	"eventBindingActionName": "Sample Name" Type: String The name of the object associated with the eventBindingActionId property.
accessTypeId	"accessTypeId": 9 Type: Number Unique identifier for the associated AccessType object.
accessTypeName	"accessTypeName": "Sample Name" Type: String The name of the object associated with the accessTypeId property.
createdByUserId	"createdByUserId": 9 Type: Number Unique identifier for the associated User object.
createdByUserName	"createdByUserName": "Sample Name" Type: String The name of the object associated with the createdByUserId property.
updatedByUserId	"updatedByUserId": 16 Type: Number Unique identifier for the associated User object.
updatedByUserName	"updatedByUserName": "Sample Name" Type: String The name of the object associated with the updatedByUserId property.
created READ-ONLY	"created": "2021-04-26T15:25:27.587Z" Type: Date This is a system generated date when the record was created. Date and time values are specified in the ISO 8601 format.

Patch Types

The PATCH verb allows you to update an object. Just like a put, you only need to supply the fields that will be updated in the payload. However, a patch allows you to update many objects at once.

PATCH operations can be used as a standard API call. Below you will find the child objects that can be updated as part of PATCH operations for the EventSubscription object.

Standard PATCH objects:

eventSubscriptionFilter - create, update, delete
webhookConfiguration - create, update, delete

DataFlow PATCH objects:

eventSubscription - create, update, delete
eventSubscriptionFilter - create, update, delete
webhookConfiguration - create, update, delete

End Points

DELETE	EventSubscription/Email/{id}
Delete an instance of the EventSubscription object. Upon successful delete, this API will return a record of all of the related objects deleted with this operation. The specifics on which objects have been deleted will depend on which related objects have been populated in the system.
{id}	Unique identifier for the EventSubscription object.
Delete an instance of the EventSubscription object. DELETE EventSubscription/Email/{id} View Sample Response HTTP/1.1 200 OK { "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b", "type": "delete", "results": { "totalCount": 4, "items": [ { "identity": 1, "action": "deleted", "dtoTypeKey": "eventSubscription" }, { "lhsId": 2, "rhsId": 2, "action": "detached", "dtoTypeKey": "sampleObjectConnector" }, { "foreignKeyIdentity": 2, "action": "deleted", "dtoTypeKey": "sampleObject" } ] } }

DELETE	EventSubscription/Webhook/{id}
Delete an instance of the EventSubscription object. Upon successful delete, this API will return a record of all of the related objects deleted with this operation. The specifics on which objects have been deleted will depend on which related objects have been populated in the system.
{id}	Unique identifier for the EventSubscription object.
Delete an instance of the EventSubscription object. DELETE EventSubscription/Webhook/{id} View Sample Response HTTP/1.1 200 OK { "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b", "type": "delete", "results": { "totalCount": 4, "items": [ { "identity": 1, "action": "deleted", "dtoTypeKey": "eventSubscription" }, { "lhsId": 2, "rhsId": 2, "action": "detached", "dtoTypeKey": "sampleObjectConnector" }, { "foreignKeyIdentity": 2, "action": "deleted", "dtoTypeKey": "sampleObject" } ] } }

PATCH	EventSubscription/Email/{id}
Update or Add the EventSubscription object and optionally make changes to any child objects. Patch end points allow for adding/updating multiple related entities and the results of those changes will be reported in the response JSON payload in the items array.
{id}	Unique identifier for the EventSubscription object.
Update or Add the EventSubscription object and optionally make changes to any child objects. PATCH EventSubscription/Email/{id} { "details": {}, "eventSubscriptions": { "items": [ { "patchType": "create", "patchClientId": 1, "name": "Sample Text Data", "description": "Sample Text Data", "isActive": true, "eventRegistrationId": 7, "eventBindingActionId": 5, "accessTypeId": 20, "createdByUserId": 3, "updatedByUserId": 11 } ] } } View Sample Response HTTP/1.1 200 OK { "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b", "type": "patch", "results": { "totalCount": 1, "items": [ { "identity": 1, "action": "created", "dtoTypeKey": "eventSubscription", "instance": { "identity": 1, "name": "Sample Text Data", "description": "Sample Text Data", "isActive": true, "eventRegistrationId": 11, "eventRegistrationName": "Sample Text Data", "eventBindingActionId": 27, "eventBindingActionName": "Sample Text Data", "accessTypeId": 5, "accessTypeName": "Sample Text Data", "createdByUserId": 12, "createdByUserName": "Sample Text Data", "updatedByUserId": 20, "updatedByUserName": "Sample Text Data", "created": "2021-04-26T15:25:27.587Z" } } ] } }

PATCH	EventSubscription/Webhook/{id}
Update or Add the EventSubscription object and optionally make changes to any child objects. Patch end points allow for adding/updating multiple related entities and the results of those changes will be reported in the response JSON payload in the items array.
{id}	Unique identifier for the EventSubscription object.
Update or Add the EventSubscription object and optionally make changes to any child objects. PATCH EventSubscription/Webhook/{id} { "details": {}, "eventSubscriptions": { "items": [ { "patchType": "create", "patchClientId": 1, "name": "Sample Text Data", "description": "Sample Text Data", "isActive": true, "eventRegistrationId": 24, "eventBindingActionId": 23, "accessTypeId": 15, "createdByUserId": 2, "updatedByUserId": 11 } ] } } View Sample Response HTTP/1.1 200 OK { "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b", "type": "patch", "results": { "totalCount": 1, "items": [ { "identity": 1, "action": "created", "dtoTypeKey": "eventSubscription", "instance": { "identity": 1, "name": "Sample Text Data", "description": "Sample Text Data", "isActive": true, "eventRegistrationId": 25, "eventRegistrationName": "Sample Text Data", "eventBindingActionId": 21, "eventBindingActionName": "Sample Text Data", "accessTypeId": 11, "accessTypeName": "Sample Text Data", "createdByUserId": 26, "createdByUserName": "Sample Text Data", "updatedByUserId": 11, "updatedByUserName": "Sample Text Data", "created": "2021-04-26T15:25:27.587Z" } } ] } }

Create a new instance of the EventSubscription object.

POST EventSubscription/Email/

{
    "name": "Sample Text Data",
    "description": "Sample Text Data",
    "isActive": true,
    "eventRegistrationId": 18,
    "eventBindingActionId": 13,
    "accessTypeId": 22,
    "createdByUserId": 3,
    "updatedByUserId": 22
}

View Sample Response

HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "create",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "name": "Sample Text Data",
                "description": "Sample Text Data",
                "isActive": true,
                "eventRegistrationId": 26,
                "eventRegistrationName": "Sample Text Data",
                "eventBindingActionId": 16,
                "eventBindingActionName": "Sample Text Data",
                "accessTypeId": 23,
                "accessTypeName": "Sample Text Data",
                "createdByUserId": 10,
                "createdByUserName": "Sample Text Data",
                "updatedByUserId": 9,
                "updatedByUserName": "Sample Text Data",
                "created": "2021-04-26T15:25:27.587Z"
            }
        ]
    }
}

Create a new instance of the EventSubscription object.

POST EventSubscription/Webhook/

{
    "name": "Sample Text Data",
    "description": "Sample Text Data",
    "isActive": true,
    "eventRegistrationId": 9,
    "eventBindingActionId": 1,
    "accessTypeId": 7,
    "createdByUserId": 22,
    "updatedByUserId": 27
}

View Sample Response

HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "create",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "name": "Sample Text Data",
                "description": "Sample Text Data",
                "isActive": true,
                "eventRegistrationId": 22,
                "eventRegistrationName": "Sample Text Data",
                "eventBindingActionId": 9,
                "eventBindingActionName": "Sample Text Data",
                "accessTypeId": 10,
                "accessTypeName": "Sample Text Data",
                "createdByUserId": 3,
                "createdByUserName": "Sample Text Data",
                "updatedByUserId": 22,
                "updatedByUserName": "Sample Text Data",
                "created": "2021-04-26T15:25:27.587Z"
            }
        ]
    }
}

Update an existing instance of the EventSubscription object.

PUT EventSubscription/Email/{id}

{
    "identity": 1,
    "name": "Sample Text Data",
    "description": "Sample Text Data",
    "isActive": true,
    "eventRegistrationId": 1,
    "eventBindingActionId": 23,
    "accessTypeId": 27,
    "createdByUserId": 23,
    "updatedByUserId": 9
}

View Sample Response

HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "update",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "name": "Sample Text Data",
                "description": "Sample Text Data",
                "isActive": true,
                "eventRegistrationId": 25,
                "eventRegistrationName": "Sample Text Data",
                "eventBindingActionId": 26,
                "eventBindingActionName": "Sample Text Data",
                "accessTypeId": 3,
                "accessTypeName": "Sample Text Data",
                "createdByUserId": 16,
                "createdByUserName": "Sample Text Data",
                "updatedByUserId": 14,
                "updatedByUserName": "Sample Text Data",
                "created": "2021-04-26T15:25:27.587Z"
            }
        ]
    }
}

Update an existing instance of the EventSubscription object.

PUT EventSubscription/Webhook/{id}

{
    "identity": 1,
    "name": "Sample Text Data",
    "description": "Sample Text Data",
    "isActive": true,
    "eventRegistrationId": 27,
    "eventBindingActionId": 10,
    "accessTypeId": 23,
    "createdByUserId": 2,
    "updatedByUserId": 9
}

View Sample Response

HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "type": "update",
    "results": {
        "totalCount": 1,
        "items": [
            {
                "identity": 1,
                "name": "Sample Text Data",
                "description": "Sample Text Data",
                "isActive": true,
                "eventRegistrationId": 3,
                "eventRegistrationName": "Sample Text Data",
                "eventBindingActionId": 12,
                "eventBindingActionName": "Sample Text Data",
                "accessTypeId": 25,
                "accessTypeName": "Sample Text Data",
                "createdByUserId": 20,
                "createdByUserName": "Sample Text Data",
                "updatedByUserId": 18,
                "updatedByUserName": "Sample Text Data",
                "created": "2021-04-26T15:25:27.587Z"
            }
        ]
    }
}