Adding Filters to Subscriptions

You can add filters to your subscriptions so that they only receive information when the criteria you enter is met.

Note:

The filters explained in this topic refer to conditions that apply to the data at the parent level in the message.

In addition to these filters, you can also specify a child filter key on child object mappings to determine whether to create or update child records. When you specify a child filter key, a child record is only created or updated when the message value for that key is true. For example, if you define a child filter key based on an Active checkbox, records are only created or updated if the checkbox is selected on the source record. For more information, see Adding Mappings to a Messaging Relationship.

You can also add delivery filters to messaging relationships so that messages are only sent when data on the source meets the specified criteria. For more information, see Mappings Overview.

To add a filter to a subscription:

  1. On the Message Types tab, click the name of the message type that contains the subscription you want to customize.
  2. Click the Subscriptions link to view subscriptions.
  3. Click the name of the subscription you want to edit.
  4. In the Filters section, enter the message key on which to apply the filter.
  5. Select the operator you want for the filter.
  6. Enter the value on which to filter.
  7. [Optional] Click Add and repeat the last three steps until you have added the filters that you want.
  8. [Optional] Specify filter logic:
    1. Click Add Filter Logic.
    2. Enter the logic that you want to connect each filter with in the box that appears. For example, for the subscription to receive the information with:
      • 1 AND 2 — Filters 1 and 2 must evaluate to true
      • 1 OR 2 — Filter 1 or 2 must evaluate to true
      • 1 AND NOT(2) — Filter 1 must evaluate to true and filter 2 must evaluate to false
    Note:

    You do not need to add filter logic if you want the default AND filter logic.

    Each successive connector must be the same or contained within brackets. For example, you can enter 1 AND (2 OR 3), but not 1 AND 2 OR 3.

  9. Click Save.
Note:

If you want to create a filter based on a date time in the message, ensure you specify it in both GMT and JSON format.

For example, if you want to specify 4:30PM (16:30) on the 31st January 2021 and you are located in a timezone that is two hours ahead of Greenwich Mean Time, specify 2021-01-31T14:30:00.000+0000.