.. _configure_northbound_notification_event_attributes:

Configure Northbound Notification Event Attributes
--------------------------------------------------

You can use attribute selectors to define the attributes to be received in a
notification for a particular event. Notifications contain only the specified
fields and are not sent if none of the fields are chosen.

.. note::

   You cannot delete an attribute selector until it is removed or disassociated
   from all events.

.. important::

   It is possible to create an attribute selector through the API with 'invalid'
   attributes as there is no API validation on the list of attributes. We
   recommend using the GUI or API to retrieve the list of attributes prior to
   creating an attribute list through the API. Refer to the API Reference Guide.
   If an invalid attribute is added to an attribute filter, the transaction will
   succeed but notifications will not contain the chosen field.

Procedure
.........

1. Log in as provider administrator.
2. Choose **Administration Tools > Northbound Notifications > Attributes**.
3. Click **Add**.
4. Enter a unique name.
5. Choose a model type: either data/NormalizedUser or relation/Subscriber.
6. Highlight one or more attributes and perform the following:

   * Click **Select** to add an attribute to the list of chosen attributes. You
     can also select multiple attributes at a time by highlighting them and
     clicking **Select**. The attributes move from the **Available** box to the
     **Selected** box.
   * Click **Remove** to remove an attribute from the list of chosen attributes.
     You can also remove multiple attributes at a time by highlighting them and
     clicking **Remove**. The attributes move from the **Selected** box to the
     **Available** box.
     
   Example: For the data/NormalizedUser model, you could select Username,
   First Name, Last Name, Phone Number, and Mail. Notifications are then sent
   when an event occurs that includes one or more of these attributes.
   
7. Click **Save**.

What to Do Next
...............

Apply the event attributes to an event by adding or updating the event and
choosing the desired attribute selector.