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

# Partner quickstart

> Send one obligation and receive a signed test event.

## 1. Obtain an API key

Sign in to your partner workspace and open **Partner platforms → Developers**. Generate a key with `obligations:write`, `obligations:read`, `events:read`, and `webhooks:manage`. If you do not have partner access yet, ask Already to add you. The secret is displayed once. Store it on your server or in a secret manager; it must never be embedded in browser code.

## 2. Submit an obligation

Set `ALREADY_API_BASE_URL` to the development API URL supplied by Already. Use a unique `Idempotency-Key` for each new submission. This example uses placeholder parties and dates; choose a future due date in your test environment.

```sh theme={null}
curl -X POST "$ALREADY_API_BASE_URL/partner/v1/obligation-submissions" \
  -H "Authorization: Bearer $ALREADY_PARTNER_API_KEY" \
  -H "Idempotency-Key: demo-invoice-1001-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "INV-1001",
    "externalVersion": "1",
    "type": "invoice",
    "beneficiary": {"email": "business@example.com", "name": "Example Staffing"},
    "payerName": "Example Hospital",
    "faceAmount": 2040,
    "currency": "USD",
    "dueAt": "2027-03-31",
    "evidence": {"type": "timesheet_approved", "reference": "TS-1001"}
  }'
```

The response contains a submission with status `received`. **Submission is not an offer.** An Already operator reviews it, chooses funded capacity, and publishes an offer if approved. See [submission rules](https://docs.already.finance/integrate/submissions.md).

## 3. Register and test your webhook

Register a public HTTPS callback in **Partner platforms → Developers** or with `POST /partner/v1/webhooks`. Save the one-time signing secret and verify every delivery. Send a test event, then confirm an `integration.test` event reaches your receiver. See [webhooks](https://docs.already.finance/integrate/webhooks.md).

## 4. Follow the offer

Listen for `submission.approved`, `obligation.created`, and `offer.available`. You can also poll [the event cursor](https://docs.already.finance/reference/partner-api.md) after an outage. Once the business accepts, subsequent events track acceptance, payout, and repayment.


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