# Getting started

## Send an application notification

1. Register or log in at <https://agentpushkit.com>.
2. In Settings, choose the customer account and regenerate its application API key. Copy the `apk_…` value; it is shown only once.
3. Send an event:

```bash
curl https://api.chatdna.co/agent-push-kit/v1/events \
  -H 'Authorization: Bearer apk_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "service": "billing",
    "type": "invoice.paid",
    "title": "Invoice paid",
    "body": "Acme paid invoice #1042",
    "externalId": "invoice_1042_paid",
    "actionUrl": "https://example.com/invoices/1042",
    "metadata": {"invoiceId": "1042", "amount": 4900}
  }'
```

`service`, `type`, `title`, and `body` are required. Service names and exact notification types require no configuration. Reusing an `externalId` within one service returns the original event and does not send another push.

## Connect an agent

1. Open <https://agentpushkit.com/connect-agent> while logged in.
2. Create and name an agent token.
3. Copy the `apt_…` token once.
4. Use the generated setup prompt, install the [skill](./skill.md), connect [MCP](./mcp.md), or install an [SDK](./sdks.md).

An agent token can perform every authenticated product operation and is subject to the same owner/member checks as its creator.