# Event Subscriptions
> Webhooks are event notifications we send to you by HTTPS POST requests. Event Subscriptions are how you configure your application to listen for them. You can create an Event Subscription through your [developer dashboard](https://dashboard.increase.com/developers/webhooks) or the API. For more information, see our [webhooks guide](https://increase.com/documentation/webhooks).

[Events](https://increase.com/documentation/events.md) will be generated for this resource. The possible event categories are: `event_subscription.created` and `event_subscription.updated`.

## The Event Subscription object
### Example
```json
{
  "created_at": "2020-01-31T23:59:59Z",
  "id": "event_subscription_001dzz0r20rcdxgb013zqb8m04g",
  "idempotency_key": null,
  "oauth_connection_id": null,
  "selected_event_categories": null,
  "status": "active",
  "type": "event_subscription",
  "url": "https://website.com/webhooks"
}
```
### Attributes
- `created_at` (string)
  The time the event subscription was created.

- `id` (string)
  The event subscription identifier.

- `idempotency_key` (string, nullable)
  The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

- `oauth_connection_id` (string, nullable)
  If specified, this subscription will only receive webhooks for Events associated with this OAuth Connection.

- `selected_event_categories` (array of objects, nullable)
  If specified, this subscription will only receive webhooks for Events with the specified `category`.

  - `selected_event_categories.event_category` (enum, nullable)
    The category of the Event.
    Cases:
    * `account.created` (Occurs whenever an Account is created.)
    * `account.updated` (Occurs whenever an Account is updated.)
    * `account_number.created` (Occurs whenever an Account Number is created.)
    * `account_number.updated` (Occurs whenever an Account Number is updated.)
    * `account_statement.created` (Occurs whenever an Account Statement is created.)
    * `account_transfer.created` (Occurs whenever an Account Transfer is created.)
    * `account_transfer.updated` (Occurs whenever an Account Transfer is updated.)
    * `ach_prenotification.created` (Occurs whenever an ACH Prenotification is created.)
    * `ach_prenotification.updated` (Occurs whenever an ACH Prenotification is updated.)
    * `ach_transfer.created` (Occurs whenever an ACH Transfer is created.)
    * `ach_transfer.updated` (Occurs whenever an ACH Transfer is updated.)
    * `blockchain_address.created` (Occurs whenever a Blockchain Address is created.)
    * `blockchain_address.updated` (Occurs whenever a Blockchain Address is updated.)
    * `blockchain_offramp_transfer.created` (Occurs whenever a Blockchain Off-Ramp Transfer is created.)
    * `blockchain_offramp_transfer.updated` (Occurs whenever a Blockchain Off-Ramp Transfer is updated.)
    * `blockchain_onramp_transfer.created` (Occurs whenever a Blockchain On-Ramp Transfer is created.)
    * `blockchain_onramp_transfer.updated` (Occurs whenever a Blockchain On-Ramp Transfer is updated.)
    * `bookkeeping_account.created` (Occurs whenever a Bookkeeping Account is created.)
    * `bookkeeping_account.updated` (Occurs whenever a Bookkeeping Account is updated.)
    * `bookkeeping_entry_set.updated` (Occurs whenever a Bookkeeping Entry Set is created.)
    * `card.created` (Occurs whenever a Card is created.)
    * `card.updated` (Occurs whenever a Card is updated.)
    * `card_payment.created` (Occurs whenever a Card Payment is created.)
    * `card_payment.updated` (Occurs whenever a Card Payment is updated.)
    * `card_purchase_supplement.created` (Occurs whenever a Card Purchase Supplement is created.)
    * `card_profile.created` (Occurs whenever a Card Profile is created.)
    * `card_profile.updated` (Occurs whenever a Card Profile is updated.)
    * `card_dispute.created` (Occurs whenever a Card Dispute is created.)
    * `card_dispute.updated` (Occurs whenever a Card Dispute is updated.)
    * `check_deposit.created` (Occurs whenever a Check Deposit is created.)
    * `check_deposit.updated` (Occurs whenever a Check Deposit is updated.)
    * `check_transfer.created` (Occurs whenever a Check Transfer is created.)
    * `check_transfer.updated` (Occurs whenever a Check Transfer is updated.)
    * `declined_transaction.created` (Occurs whenever a Declined Transaction is created.)
    * `digital_card_profile.created` (Occurs whenever a Digital Card Profile is created.)
    * `digital_card_profile.updated` (Occurs whenever a Digital Card Profile is updated.)
    * `digital_wallet_token.created` (Occurs whenever a Digital Wallet Token is created.)
    * `digital_wallet_token.updated` (Occurs whenever a Digital Wallet Token is updated.)
    * `document.created` (Occurs whenever a Document is created.)
    * `entity.created` (Occurs whenever an Entity is created.)
    * `entity.updated` (Occurs whenever an Entity is updated.)
    * `event_subscription.created` (Occurs whenever an Event Subscription is created.)
    * `event_subscription.updated` (Occurs whenever an Event Subscription is updated.)
    * `export.created` (Occurs whenever an Export is created.)
    * `export.updated` (Occurs whenever an Export is updated.)
    * `external_account.created` (Occurs whenever an External Account is created.)
    * `external_account.updated` (Occurs whenever an External Account is updated.)
    * `fednow_transfer.created` (Occurs whenever a FedNow Transfer is created.)
    * `fednow_transfer.updated` (Occurs whenever a FedNow Transfer is updated.)
    * `file.created` (Occurs whenever a File is created.)
    * `group.updated` (Occurs whenever a Group is updated.)
    * `group.heartbeat` (Increase may send webhooks with this category to see if a webhook endpoint is working properly.)
    * `inbound_ach_transfer.created` (Occurs whenever an Inbound ACH Transfer is created.)
    * `inbound_ach_transfer.updated` (Occurs whenever an Inbound ACH Transfer is updated.)
    * `inbound_ach_transfer_return.created` (Occurs whenever an Inbound ACH Transfer Return is created.)
    * `inbound_ach_transfer_return.updated` (Occurs whenever an Inbound ACH Transfer Return is updated.)
    * `inbound_check_deposit.created` (Occurs whenever an Inbound Check Deposit is created.)
    * `inbound_check_deposit.updated` (Occurs whenever an Inbound Check Deposit is updated.)
    * `inbound_fednow_transfer.created` (Occurs whenever an Inbound FedNow Transfer is created.)
    * `inbound_fednow_transfer.updated` (Occurs whenever an Inbound FedNow Transfer is updated.)
    * `inbound_mail_item.created` (Occurs whenever an Inbound Mail Item is created.)
    * `inbound_mail_item.updated` (Occurs whenever an Inbound Mail Item is updated.)
    * `inbound_real_time_payments_transfer.created` (Occurs whenever an Inbound Real-Time Payments Transfer is created.)
    * `inbound_real_time_payments_transfer.updated` (Occurs whenever an Inbound Real-Time Payments Transfer is updated.)
    * `inbound_wire_drawdown_request.created` (Occurs whenever an Inbound Wire Drawdown Request is created.)
    * `inbound_wire_transfer.created` (Occurs whenever an Inbound Wire Transfer is created.)
    * `inbound_wire_transfer.updated` (Occurs whenever an Inbound Wire Transfer is updated.)
    * `intrafi_account_enrollment.created` (Occurs whenever an IntraFi Account Enrollment is created.)
    * `intrafi_account_enrollment.updated` (Occurs whenever an IntraFi Account Enrollment is updated.)
    * `intrafi_exclusion.created` (Occurs whenever an IntraFi Exclusion is created.)
    * `intrafi_exclusion.updated` (Occurs whenever an IntraFi Exclusion is updated.)
    * `legacy_card_dispute.created` (Occurs whenever a Legacy Card Dispute is created.)
    * `legacy_card_dispute.updated` (Occurs whenever a Legacy Card Dispute is updated.)
    * `lockbox.created` (Occurs whenever a Lockbox is created.)
    * `lockbox.updated` (Occurs whenever a Lockbox is updated.)
    * `oauth_connection.created` (Occurs whenever an OAuth Connection is created.)
    * `oauth_connection.deactivated` (Occurs whenever an OAuth Connection is deactivated.)
    * `card_push_transfer.created` (Occurs whenever a Card Push Transfer is created.)
    * `card_push_transfer.updated` (Occurs whenever a Card Push Transfer is updated.)
    * `card_validation.created` (Occurs whenever a Card Validation is created.)
    * `card_validation.updated` (Occurs whenever a Card Validation is updated.)
    * `pending_transaction.created` (Occurs whenever a Pending Transaction is created.)
    * `pending_transaction.updated` (Occurs whenever a Pending Transaction is updated.)
    * `physical_card.created` (Occurs whenever a Physical Card is created.)
    * `physical_card.updated` (Occurs whenever a Physical Card is updated.)
    * `physical_card_profile.created` (Occurs whenever a Physical Card Profile is created.)
    * `physical_card_profile.updated` (Occurs whenever a Physical Card Profile is updated.)
    * `physical_check.created` (Occurs whenever a Physical Check is created.)
    * `physical_check.updated` (Occurs whenever a Physical Check is updated.)
    * `program.created` (Occurs whenever a Program is created.)
    * `program.updated` (Occurs whenever a Program is updated.)
    * `proof_of_authorization_request.created` (Occurs whenever a Proof of Authorization Request is created.)
    * `proof_of_authorization_request.updated` (Occurs whenever a Proof of Authorization Request is updated.)
    * `real_time_decision.card_authorization_requested` (Occurs whenever a Real-Time Decision is created in response to a card authorization.)
    * `real_time_decision.card_balance_inquiry_requested` (Occurs whenever a Real-Time Decision is created in response to a card balance inquiry.)
    * `real_time_decision.digital_wallet_token_requested` (Occurs whenever a Real-Time Decision is created in response to a digital wallet provisioning attempt.)
    * `real_time_decision.digital_wallet_authentication_requested` (Occurs whenever a Real-Time Decision is created in response to a digital wallet requiring two-factor authentication.)
    * `real_time_decision.card_authentication_requested` (Occurs whenever a Real-Time Decision is created in response to 3DS authentication.)
    * `real_time_decision.card_authentication_challenge_requested` (Occurs whenever a Real-Time Decision is created in response to 3DS authentication challenges.)
    * `real_time_payments_transfer.created` (Occurs whenever a Real-Time Payments Transfer is created.)
    * `real_time_payments_transfer.updated` (Occurs whenever a Real-Time Payments Transfer is updated.)
    * `real_time_payments_request_for_payment.created` (Occurs whenever a Real-Time Payments Request for Payment is created.)
    * `real_time_payments_request_for_payment.updated` (Occurs whenever a Real-Time Payments Request for Payment is updated.)
    * `swift_transfer.created` (Occurs whenever a Swift Transfer is created.)
    * `swift_transfer.updated` (Occurs whenever a Swift Transfer is updated.)
    * `transaction.created` (Occurs whenever a Transaction is created.)
    * `wire_drawdown_request.created` (Occurs whenever a Wire Drawdown Request is created.)
    * `wire_drawdown_request.updated` (Occurs whenever a Wire Drawdown Request is updated.)
    * `wire_transfer.created` (Occurs whenever a Wire Transfer is created.)
    * `wire_transfer.updated` (Occurs whenever a Wire Transfer is updated.)

- `status` (enum)
  This indicates if we'll send notifications to this subscription.
  Cases:
  * `active` (The subscription is active and Events will be delivered normally.)
  * `disabled` (The subscription is temporarily disabled and Events will not be delivered.)
  * `deleted` (The subscription is permanently disabled and Events will not be delivered.)
  * `requires_attention` (The subscription is temporarily disabled due to delivery errors and Events will not be delivered.)

- `type` (string)
  A constant representing the object's type. For this resource it will always be `event_subscription`.

- `url` (string)
  The webhook url where we'll send notifications.

## List Event Subscriptions
GET /event_subscriptions

### Example
```curl
curl \
  --url "${INCREASE_URL}/event_subscriptions" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"
```

### Query Parameters
- `cursor` (string, optional)
  Return the page of entries after this one.

- `limit` (integer, optional)
  Limit the size of the list that is returned. The default (and maximum) is 100 objects.

- `idempotency_key` (string, optional)
  Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

### Returns a Event Subscription List object:
```json
{
  "data": [
    {
      "created_at": "2020-01-31T23:59:59Z",
      "id": "event_subscription_001dzz0r20rcdxgb013zqb8m04g",
      "idempotency_key": null,
      "oauth_connection_id": null,
      "selected_event_categories": null,
      "status": "active",
      "type": "event_subscription",
      "url": "https://website.com/webhooks"
    }
  ],
  "next_cursor": "v57w5d"
}
```

## Create an Event Subscription
POST /event_subscriptions

### Example
```curl
curl -X "POST" \
  --url "${INCREASE_URL}/event_subscriptions" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "url": "https://website.com/webhooks"
  }'
```

### Body Parameters
- `oauth_connection_id` (string, optional)
  If specified, this subscription will only receive webhooks for Events associated with the specified OAuth Connection.

- `selected_event_categories` (array of objects, optional)
  If specified, this subscription will only receive webhooks for Events with the specified `category`. If specifying a Real-Time Decision event category, only one Event Category can be specified for the Event Subscription.

  - `selected_event_categories.event_category` (enum, required)
    The category of the Event to subscribe to.
    Cases:
    * `account.created` (Occurs whenever an Account is created.)
    * `account.updated` (Occurs whenever an Account is updated.)
    * `account_number.created` (Occurs whenever an Account Number is created.)
    * `account_number.updated` (Occurs whenever an Account Number is updated.)
    * `account_statement.created` (Occurs whenever an Account Statement is created.)
    * `account_transfer.created` (Occurs whenever an Account Transfer is created.)
    * `account_transfer.updated` (Occurs whenever an Account Transfer is updated.)
    * `ach_prenotification.created` (Occurs whenever an ACH Prenotification is created.)
    * `ach_prenotification.updated` (Occurs whenever an ACH Prenotification is updated.)
    * `ach_transfer.created` (Occurs whenever an ACH Transfer is created.)
    * `ach_transfer.updated` (Occurs whenever an ACH Transfer is updated.)
    * `blockchain_address.created` (Occurs whenever a Blockchain Address is created.)
    * `blockchain_address.updated` (Occurs whenever a Blockchain Address is updated.)
    * `blockchain_offramp_transfer.created` (Occurs whenever a Blockchain Off-Ramp Transfer is created.)
    * `blockchain_offramp_transfer.updated` (Occurs whenever a Blockchain Off-Ramp Transfer is updated.)
    * `blockchain_onramp_transfer.created` (Occurs whenever a Blockchain On-Ramp Transfer is created.)
    * `blockchain_onramp_transfer.updated` (Occurs whenever a Blockchain On-Ramp Transfer is updated.)
    * `bookkeeping_account.created` (Occurs whenever a Bookkeeping Account is created.)
    * `bookkeeping_account.updated` (Occurs whenever a Bookkeeping Account is updated.)
    * `bookkeeping_entry_set.updated` (Occurs whenever a Bookkeeping Entry Set is created.)
    * `card.created` (Occurs whenever a Card is created.)
    * `card.updated` (Occurs whenever a Card is updated.)
    * `card_payment.created` (Occurs whenever a Card Payment is created.)
    * `card_payment.updated` (Occurs whenever a Card Payment is updated.)
    * `card_purchase_supplement.created` (Occurs whenever a Card Purchase Supplement is created.)
    * `card_profile.created` (Occurs whenever a Card Profile is created.)
    * `card_profile.updated` (Occurs whenever a Card Profile is updated.)
    * `card_dispute.created` (Occurs whenever a Card Dispute is created.)
    * `card_dispute.updated` (Occurs whenever a Card Dispute is updated.)
    * `check_deposit.created` (Occurs whenever a Check Deposit is created.)
    * `check_deposit.updated` (Occurs whenever a Check Deposit is updated.)
    * `check_transfer.created` (Occurs whenever a Check Transfer is created.)
    * `check_transfer.updated` (Occurs whenever a Check Transfer is updated.)
    * `declined_transaction.created` (Occurs whenever a Declined Transaction is created.)
    * `digital_card_profile.created` (Occurs whenever a Digital Card Profile is created.)
    * `digital_card_profile.updated` (Occurs whenever a Digital Card Profile is updated.)
    * `digital_wallet_token.created` (Occurs whenever a Digital Wallet Token is created.)
    * `digital_wallet_token.updated` (Occurs whenever a Digital Wallet Token is updated.)
    * `document.created` (Occurs whenever a Document is created.)
    * `entity.created` (Occurs whenever an Entity is created.)
    * `entity.updated` (Occurs whenever an Entity is updated.)
    * `event_subscription.created` (Occurs whenever an Event Subscription is created.)
    * `event_subscription.updated` (Occurs whenever an Event Subscription is updated.)
    * `export.created` (Occurs whenever an Export is created.)
    * `export.updated` (Occurs whenever an Export is updated.)
    * `external_account.created` (Occurs whenever an External Account is created.)
    * `external_account.updated` (Occurs whenever an External Account is updated.)
    * `fednow_transfer.created` (Occurs whenever a FedNow Transfer is created.)
    * `fednow_transfer.updated` (Occurs whenever a FedNow Transfer is updated.)
    * `file.created` (Occurs whenever a File is created.)
    * `group.updated` (Occurs whenever a Group is updated.)
    * `group.heartbeat` (Increase may send webhooks with this category to see if a webhook endpoint is working properly.)
    * `inbound_ach_transfer.created` (Occurs whenever an Inbound ACH Transfer is created.)
    * `inbound_ach_transfer.updated` (Occurs whenever an Inbound ACH Transfer is updated.)
    * `inbound_ach_transfer_return.created` (Occurs whenever an Inbound ACH Transfer Return is created.)
    * `inbound_ach_transfer_return.updated` (Occurs whenever an Inbound ACH Transfer Return is updated.)
    * `inbound_check_deposit.created` (Occurs whenever an Inbound Check Deposit is created.)
    * `inbound_check_deposit.updated` (Occurs whenever an Inbound Check Deposit is updated.)
    * `inbound_fednow_transfer.created` (Occurs whenever an Inbound FedNow Transfer is created.)
    * `inbound_fednow_transfer.updated` (Occurs whenever an Inbound FedNow Transfer is updated.)
    * `inbound_mail_item.created` (Occurs whenever an Inbound Mail Item is created.)
    * `inbound_mail_item.updated` (Occurs whenever an Inbound Mail Item is updated.)
    * `inbound_real_time_payments_transfer.created` (Occurs whenever an Inbound Real-Time Payments Transfer is created.)
    * `inbound_real_time_payments_transfer.updated` (Occurs whenever an Inbound Real-Time Payments Transfer is updated.)
    * `inbound_wire_drawdown_request.created` (Occurs whenever an Inbound Wire Drawdown Request is created.)
    * `inbound_wire_transfer.created` (Occurs whenever an Inbound Wire Transfer is created.)
    * `inbound_wire_transfer.updated` (Occurs whenever an Inbound Wire Transfer is updated.)
    * `intrafi_account_enrollment.created` (Occurs whenever an IntraFi Account Enrollment is created.)
    * `intrafi_account_enrollment.updated` (Occurs whenever an IntraFi Account Enrollment is updated.)
    * `intrafi_exclusion.created` (Occurs whenever an IntraFi Exclusion is created.)
    * `intrafi_exclusion.updated` (Occurs whenever an IntraFi Exclusion is updated.)
    * `legacy_card_dispute.created` (Occurs whenever a Legacy Card Dispute is created.)
    * `legacy_card_dispute.updated` (Occurs whenever a Legacy Card Dispute is updated.)
    * `lockbox.created` (Occurs whenever a Lockbox is created.)
    * `lockbox.updated` (Occurs whenever a Lockbox is updated.)
    * `oauth_connection.created` (Occurs whenever an OAuth Connection is created.)
    * `oauth_connection.deactivated` (Occurs whenever an OAuth Connection is deactivated.)
    * `card_push_transfer.created` (Occurs whenever a Card Push Transfer is created.)
    * `card_push_transfer.updated` (Occurs whenever a Card Push Transfer is updated.)
    * `card_validation.created` (Occurs whenever a Card Validation is created.)
    * `card_validation.updated` (Occurs whenever a Card Validation is updated.)
    * `pending_transaction.created` (Occurs whenever a Pending Transaction is created.)
    * `pending_transaction.updated` (Occurs whenever a Pending Transaction is updated.)
    * `physical_card.created` (Occurs whenever a Physical Card is created.)
    * `physical_card.updated` (Occurs whenever a Physical Card is updated.)
    * `physical_card_profile.created` (Occurs whenever a Physical Card Profile is created.)
    * `physical_card_profile.updated` (Occurs whenever a Physical Card Profile is updated.)
    * `physical_check.created` (Occurs whenever a Physical Check is created.)
    * `physical_check.updated` (Occurs whenever a Physical Check is updated.)
    * `program.created` (Occurs whenever a Program is created.)
    * `program.updated` (Occurs whenever a Program is updated.)
    * `proof_of_authorization_request.created` (Occurs whenever a Proof of Authorization Request is created.)
    * `proof_of_authorization_request.updated` (Occurs whenever a Proof of Authorization Request is updated.)
    * `real_time_decision.card_authorization_requested` (Occurs whenever a Real-Time Decision is created in response to a card authorization.)
    * `real_time_decision.card_balance_inquiry_requested` (Occurs whenever a Real-Time Decision is created in response to a card balance inquiry.)
    * `real_time_decision.digital_wallet_token_requested` (Occurs whenever a Real-Time Decision is created in response to a digital wallet provisioning attempt.)
    * `real_time_decision.digital_wallet_authentication_requested` (Occurs whenever a Real-Time Decision is created in response to a digital wallet requiring two-factor authentication.)
    * `real_time_decision.card_authentication_requested` (Occurs whenever a Real-Time Decision is created in response to 3DS authentication.)
    * `real_time_decision.card_authentication_challenge_requested` (Occurs whenever a Real-Time Decision is created in response to 3DS authentication challenges.)
    * `real_time_payments_transfer.created` (Occurs whenever a Real-Time Payments Transfer is created.)
    * `real_time_payments_transfer.updated` (Occurs whenever a Real-Time Payments Transfer is updated.)
    * `real_time_payments_request_for_payment.created` (Occurs whenever a Real-Time Payments Request for Payment is created.)
    * `real_time_payments_request_for_payment.updated` (Occurs whenever a Real-Time Payments Request for Payment is updated.)
    * `swift_transfer.created` (Occurs whenever a Swift Transfer is created.)
    * `swift_transfer.updated` (Occurs whenever a Swift Transfer is updated.)
    * `transaction.created` (Occurs whenever a Transaction is created.)
    * `wire_drawdown_request.created` (Occurs whenever a Wire Drawdown Request is created.)
    * `wire_drawdown_request.updated` (Occurs whenever a Wire Drawdown Request is updated.)
    * `wire_transfer.created` (Occurs whenever a Wire Transfer is created.)
    * `wire_transfer.updated` (Occurs whenever a Wire Transfer is updated.)

- `shared_secret` (string, optional)
  The key that will be used to sign webhooks. If no value is passed, a random string will be used as default.

- `status` (enum, optional)
  The status of the event subscription. Defaults to `active` if not specified.
  Cases:
  * `active` (The subscription is active and Events will be delivered normally.)
  * `disabled` (The subscription is temporarily disabled and Events will not be delivered.)

- `url` (string, required)
  The URL you'd like us to send webhooks to.

## Retrieve an Event Subscription
GET /event_subscriptions/{event_subscription_id}

### Example
```curl
curl \
  --url "${INCREASE_URL}/event_subscriptions/event_subscription_001dzz0r20rcdxgb013zqb8m04g" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"
```
### Path Parameters
- `event_subscription_id` (string, required)
  The identifier of the Event Subscription.

## Update an Event Subscription
PATCH /event_subscriptions/{event_subscription_id}

### Example
```curl
curl -X "PATCH" \
  --url "${INCREASE_URL}/event_subscriptions/event_subscription_001dzz0r20rcdxgb013zqb8m04g" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{}'
```
### Path Parameters
- `event_subscription_id` (string, required)
  The identifier of the Event Subscription.

### Body Parameters
- `status` (enum, optional)
  The status to update the Event Subscription with.
  Cases:
  * `active` (The subscription is active and Events will be delivered normally.)
  * `disabled` (The subscription is temporarily disabled and Events will not be delivered.)
  * `deleted` (The subscription is permanently disabled and Events will not be delivered.)