### event_subscription_token

- **Type**: string  
- **Required**: true

#### description
- **Type**: string  
- Description of the event subscription.

#### disabled
- **Type**: boolean  
- **Defaults**: false  
- Whether the event subscription is active (false) or inactive (true).

#### event_types
- **Type**: array of objects  
- Indicates types of events that will be sent to this subscription. If left blank, all types will be sent.

### Possible Event Types
- **account_holder_document.updated**: Occurs when an account holder's document upload status has been updated.
- **account_holder.created**: Occurs when a new account_holder is created.
- **account_holder.updated**: Occurs when an account_holder is updated.
- **account_holder.verification**: Occurs when an asynchronous account_holder's verification is completed.
- **auth_rules.backtest_report.created**: Auth Rules backtest report created.
- **balance.updated**: Financial Account Balance Update.
- **book_transfer_transaction.created**: Occurs when a book transfer transaction is created.
- **book_transfer_transaction.updated**: Occurs when a book transfer transaction is updated.
- **card_authorization.challenge**: Occurs when an Out of Band challenge is issued during card authorization.
- **card_authorization.challenge_response**: Occurs when a cardholder responds to a challenge during card authorization.
- **card_transaction.enhanced_data.created**: Occurs when L2/L3 enhanced commercial data is processed for a transaction event.
- **card_transaction.enhanced_data.updated**: Occurs when L2/L3 enhanced commercial data is reprocessed for a transaction event.
- **card_transaction.updated**: Occurs when a card transaction happens.
- **card.converted**: Occurs when a card is converted from virtual to physical cards.
- **card.created**: Occurs when a new card is created.
- **card.reissued**: Occurs when a card is reissued.
- **card.renewed**: Occurs when a card is renewed.
- **card.shipped**: Occurs when a card is shipped.
- **card.updated**: Occurs when a card is updated.
- **claim_document.accepted**: Occurs when a claim document passes validation and is accepted.
- **claim_document.rejected**: Occurs when a claim document fails validation and is rejected.
- **claim_document.uploaded**: Occurs when a claim document is uploaded and begins validation.
- **claim.created**: Occurs when a dispute intake claim is created.
- **claim.updated**: Occurs when a dispute intake claim is updated.
- **digital_wallet.tokenization_result**: Occurs when a tokenization request succeeded or failed.
- **dispute_evidence.upload_failed**: Occurs when an evidence upload fails for a dispute filed through the Chargebacks API.
- **dispute_transaction.created**: Occurs when a new dispute transaction is created for a Managed Disputes case.
- **dispute_transaction.updated**: Occurs when a dispute transaction for a Managed Disputes case is updated.
- **dispute.updated**: Occurs when a dispute filed through the Chargebacks API is created or updated.
- **embed.session_generated**: Occurs when a card embed session is successfully generated.
- **embed.viewed**: Occurs when a card detail is successfully revealed through an embed.
- **external_bank_account.created**: Occurs when an external bank account is created.
- **external_bank_account.updated**: Occurs when an external bank account is updated.
- **external_payment.created**: Occurs when an external payment is created.
- **external_payment.updated**: Occurs when an external payment is updated.
- **financial_account.created**: Occurs when a financial account is created.
- **financial_account.updated**: Occurs when a financial account is updated.
- **funding_event.created**: Occurs when a funding event is created.
- **internal_transaction.created**: Occurs when an internal adjustment is created.
- **internal_transaction.updated**: Occurs when an internal adjustment is updated.
- **loan_tape.created**: Occurs when a loan tape is created.
- **loan_tape.updated**: Occurs when a loan tape is updated.
- **management_operation.created**: Occurs when a management operation is created.
- **management_operation.updated**: Occurs when a management operation is updated.
- **network_total.created**: Occurs when a network total is created.
- **network_total.updated**: Occurs when a network total is updated.
- **payment_transaction.created**: Occurs when a payment transaction is created.
- **payment_transaction.updated**: Occurs when a payment transaction is updated.
- **settlement_report.updated**: Occurs when a settlement report is created or updated.
- **statements.created**: Occurs when a statement has been created.
- **three_ds_authentication.challenge**: The three_ds_authentication.challenge event.
- **three_ds_authentication.created**: Occurs when a 3DS authentication is created.
- **three_ds_authentication.updated**: Occurs when a 3DS authentication is updated.
- **tokenization.approval_request**: Occurs when a tokenization approval request is made.
- **tokenization.result**: Occurs when a tokenization request succeeded or failed.
- **tokenization.two_factor_authentication_code**: Occurs when a tokenization request 2FA code is sent to the Lithic customer for self serve delivery.
- **tokenization.two_factor_authentication_code_sent**: Occurs when a tokenization request 2FA code is sent to our downstream messaging providers for delivery.
- **tokenization.updated**: Occurs when a tokenization's status has changed.

### Example Request:
```shell
curl --request PATCH \
     --url https://sandbox.lithic.com/v1/event_subscriptions/event_subscription_token \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "description": "string",
  "disabled": false,
  "event_types": ["account_holder_document.updated"],
  "url": "string"
}'
```

### Example Response:
```json
{
  "description": "A subscription for all events",
  "disabled": false,
  "token": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga1",
  "url": "https://example.com/webhook"
}
```