> ## Documentation Index
> Fetch the complete documentation index at: https://docs.authsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# push.created

> Sent when a push notification challenge needs to be delivered through your own push provider.

Triggered when a challenge is created for the Push authenticator.

This webhook is synchronous, so a non-2xx response fails the challenge.

Open the Push authenticator in [authenticator settings](https://portal.authsignal.com/organisations/tenants/authenticators) and enter the **Webhook URL**.

## Payload

<ParamField path="challengeId" type="string" required>
  The challenge ID to be completed using push notification.
</ParamField>

<ParamField path="userId" type="string" required>
  The ID of the user the push challenge is for.
</ParamField>

<ParamField path="idempotencyKey" type="string" required>
  The idempotency key of the request that created the push notification.
</ParamField>

<ParamField path="actionCode" type="string" required>
  The action code of the track request that created the push notification.
</ParamField>

<ParamField path="userAgent" type="string">
  The user agent of the user who requested the push notification.

  <Info>
    Only present if the user agent was captured when [tracking an
    action](/api-reference/server-api/track-action).
  </Info>
</ParamField>

<ParamField path="timezone" type="string">
  The timezone of the user who requested the push notification.

  <Info>
    Only present if the IP address was captured when [tracking an
    action](/api-reference/server-api/track-action).
  </Info>
</ParamField>

<ParamField path="ipAddress" type="string">
  The IP address of the user who requested the push notification.

  <Info>
    Only present if the IP address was captured when [tracking an
    action](/api-reference/server-api/track-action).
  </Info>
</ParamField>

<ResponseExample>
  ```json push.created theme={null}
  {
    "version": 1,
    "id": "ffffffff-ffff-ffff-ffff-ffffffffffff",
    "source": "https://authsignal.com",
    "time": "2024-01-01T01:23:45.678Z",
    "tenantId": "dddddddd-dddd-dddd-dddd-dddddddddddd",
    "type": "push.created",
    "data": {
      "challengeId": "61b5b44bea582c5f2c7e2c93f1f41d7d8f8e9fba8582a319be6a3aee696b018cc59f7d043acaaabab705c6d2b93ea1ef",
      "userId": "11111111-1111-1111-1111-111111111111",
      "idempotencyKey": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "actionCode": "sign-in",
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
      "timezone": "Europe/London",
      "ipAddress": "12.34.56.78"
    }
  }
  ```
</ResponseExample>