PlatformEventChannelMember | Tooling API

This object is available in API version 47.0 and later.

Supported SOAP Calls

create(), delete(), query(), retrieve()

Supported REST HTTP Methods

GET, POST, DELETE

Special Access Rules

You must have the Customize Application permission to access this object.

Fields

Field Name	Description
DeveloperName	Type string Properties Filter, Group, Sort Description The unique name for the PlatformEventChannelMember object. This name can contain only underscores and alphanumeric characters, and must be unique in your org. It must begin with a letter, not include spaces, not end with an underscore, and not contain two consecutive underscores. This field is automatically generated, but you can supply your own value if you create the record using the API. The developer name is in the format `ChannelName_EventName`. If your channel member name contains a custom channel name to make it unique, ensure to replace the double underscores in the name with one underscore. For example, the developer name of a member of the `MyChannel__chn` custom channel is `MyChannel_chn_AccountChangeEvent`. And the developer name of a member of the default standard channel is `ChangeEvents_AccountChangeEvent`. When creating large sets of data, always specify a unique DeveloperName for each record. If no DeveloperName is specified, performance may slow while Salesforce generates one for each record. Note
EventChannel	Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The name of a channel. For the standard channel, the name is `ChangeEvents`. For a custom channel, the name is in this format: `MyChannel__chn`.
FullName	Type string Properties Create, Group, Nillable Description The full name of the associated PlatformEventChannelMember object in Metadata API. The full name is in the format `ChannelName_EventName` and can include a namespace prefix. Two consecutive underscores in full names designate either a component name suffix or a namespace prefix. In all other cases, two consecutive underscores aren’t supported in full names. If your channel member name contains a custom channel name to make it unique, be sure to replace the double underscores in the name with one underscore. For example, the member name would be `MyChannel_chn_AccountChangeEvent` and not `MyChannel__chn_AccountChangeEvent`. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
Language	Type picklist Properties Defaulted on create, Filter, Group, Restricted picklist, Sort Description The language of the MasterLabel.
ManageableState	Type ManageableState enumerated list Properties Filter, Group, Nillable, Restricted picklist, Sort Description Indicates the manageable state of the specified component that is contained in a package: `beta` `deleted` `deprecated` `deprecatedEditable` `installed` `installedEditable` `released` `unmanaged`
Metadata	Type complexvalue Properties Create, Nillable, Update Description Platform event channel member metadata. Query this field only if the query result contains no more than one record. Otherwise, an error is returned. If more than one record exists, use multiple queries to retrieve the records. This limit protects performance.
NamespacePrefix	Type string Properties Filter, Group, Nillable, Sort Description The namespace prefix associated with this object. Each Developer Edition organization that creates a managed package has a unique namespace prefix. Limit: 15 characters. You can refer to a component in a managed package by using the `namespacePrefix__componentName` notation. The namespace prefix can have one of the following values: In Developer Edition organizations, the namespace prefix is set to the namespace prefix of the organization for all objects that support it. There is an exception if an object is in an installed managed package. In that case, the object has the namespace prefix of the installed managed package. This field’s value is the namespace prefix of the Developer Edition organization of the package developer. In organizations that are not Developer Edition organizations, NamespacePrefix is only set for objects that are part of an installed managed package. There is no namespace prefix for all other objects.
SelectedEntity	Type picklist Properties Filter, Group, Nillable, Restriced picklist, Sort Description The change event name of an entity selected for Change Data Capture notifications. For example, for the Account standard object, the name is `AccountChangeEvent`, or for a custom object MyObject__c, the name is `MyObject__ChangeEvent`.

Usage

This JSON example is the body of a REST API POST request. It adds a member to a custom channel named MyCustomChannel__chn. The corresponding REST endpoint is /services/data/47.0/tooling/sobjects/PlatformEventChannelMember.

1{
2  "FullName": "MyCustomChannel_chn_AccountChangeEvent",
3  "Metadata": {
4    "eventChannel": "MyCustomChannel__chn",
5    "selectedEntity": "AccountChangeEvent"
6  }
7}

To add a member to the ChangeEvents default channel, the request body looks as follows.

1{
2  "FullName": "ChangeEvents_AccountChangeEvent",
3  "Metadata": {
4    "eventChannel": "ChangeEvents",
5    "selectedEntity": "AccountChangeEvent"
6  }
7}

You can query PlatformEventChannelMember in SOQL over Tooling API. For example, this query returns fields of all channel members on all channels.

1SELECT Id,DeveloperName,EventChannel,SelectedEntity FROM PlatformEventChannelMember

For custom channels, the EventChannel value that the query returns is the channel ID, which starts with the 0YL prefix.

Note