# Subscribe To Notification

Creates a webhook subscription to receive real-time notifications about specific domain or account events (e.g. transfer completions, renewals).  Pass the callback URL and event types. This allows external systems to stay in sync with name.com changes.

Endpoint: POST /core/v1/notifications
Version: 1.3.1
Security: BasicAuth

## Request fields (application/json):

  - `eventName` (string, required)
    The list of configured webhooks you can subscribe to
    Enum: "domain.transfer.status_change", "account.credit.balance_change"

  - `url` (string, required)
    The URL we will send the notification data to
    Example: "https://example.com"

  - `active` (boolean, required)
    If the webhook should be active. This allows a webhook to be deactivated in our system. It may be useful to deactivate a webhook if the server that receives the POST request is undergoing scheduled maintenance, for example.

## Response 201 fields (application/json):

  - `subscription` (object)

  - `subscription.active` (boolean, required)

  - `subscription.createDate` (string, required)

  - `subscription.eventName` (string, required)

  - `subscription.id` (integer, required)

  - `subscription.updateDate` (string,null, required)

  - `subscription.url` (string, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "Unauthorized"

## Response 415 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error
    Example: "The 'Content-Type' header must be 'application/json' for this request."

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."