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

# Subscribe to Service

> Pila uses webhooks to let your application know when events happen

### Dashboard

Subscribe from **Developers → Webhooks** in the [Pila dashboard](https://dashboard.trypila.co/developers/webhooks), or use the endpoint below. See the [dashboard walkthrough](/dashboard-guide/developers/webhooks) for the full flow, including test deliveries.

<Frame caption="Webhook subscriptions in the dashboard">
  <img src="https://mintcdn.com/dojah-9b16f14e/gbqe8nXs4Wupm4KV/images/dashboard/webhooks.png?fit=max&auto=format&n=gbqe8nXs4Wupm4KV&q=85&s=a6e123ef835364117f661f2da6906f48" alt="Webhook subscriptions page in the Pila dashboard" width="1024" height="541" data-path="images/dashboard/webhooks.png" />
</Frame>

### API

This endpoint allows you to Subscribe to Pila's webhook service

### Request

```http [POST] theme={null}
{{baseUrl}}/api/v1/webhook/subscribe
```

### Headers

| Header | Type | Description |
| - | - | - |
| AppId | string | Create an app to get your app ID on dashboard [here](https://dashboard.trypila.co/developers/configuration) |
| Authorization | string | private secret key |

### Body Params

| Parameter | Type | Description | Required |
| - | - | - | - |
| webhook | string | **webhook** is the webhook url that allows Pila to send (i.e “push”) data to your application as soon as an event occurs, Create a Test webhook url on [webhook.site](https://webhook.site/). Example [https://webhook.site/db8ad2b6-91b6-485b-9761-e546b540ccf6](https://webhook.site/db8ad2b6-91b6-485b-9761-e546b540ccf6) | required |
| service | string | Type of service to subscribe to (e.g. `card`, `ngn_wallet`) | required |

### Response

```json Response theme={null}
{
 "entity": "Webhook added successfully"
}
```

#### Wallet Service notification

```json wallet theme={null}
{
  "event": "deposit",
  "status": "COMPLETED",
  "environment": "production",
  "data": {
    "wallet_id": "e10xxxxx-xxxx-xxxxx-a26e-xxxxxxxx",
    "transaction_id": "Pila-20220103060847147",
    "transaction_remarks": "deposit",
    "event_type": "wallet:event:inter",
    "transaction_date": "2022-01-18 13:34:45.992363+00:00"
  }
}

```

An active webhook allows Pila to send (i.e “push”) data to your application as soon as an event occurs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.