---
search:
  tags:
    - Partner Events
    - POST
seo:
  description: >-
    Register a receiver URL for this… Reference for the POST
    /v1/organizations/{orgId}/partner-events/subscriptions endpoint in the
    Stashtab Vault Warehouse API.
sidebar:
  label: Create a partner event subscription
  badge: POST
title: Create a partner event subscription
type: openapi-operation
---
Register a receiver URL for this organization and immutable mode. The request contains only url; delivery configuration and signing material remain private. Configured Test delivery records a capture without contacting the receiver or using a Live signing key. Delivery supports public HTTPS on port 443, rechecks resolved addresses and does not follow redirects. Repeating the exact active URL with the same configured binding returns its existing subscription; another binding conflicts. The HTTP response is data.subscription with subscriptionId, url, createdAt and revokedAt. A null revokedAt means active. Creation requires current delivery configuration and does not establish a business event, successful receiver delivery or provider acceptance.

`POST /v1/organizations/{orgId}/partner-events/subscriptions`

**Request body** (`application/json`, required)

- `url` (string<uri>, required)

Request body example:

```json
{
  "url": "https://receiver.example/events"
}
```

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "subscription": {
      "createdAt": "2026-11-05T15:00:00.000Z",
      "revokedAt": null,
      "subscriptionId": "00000000-0000-4000-8000-000000000010",
      "url": "https://receiver.example/events"
    }
  },
  "meta": {
    "requestId": "example-createPartnerEventSubscription"
  }
}
```
