---
title: "Create a sponsor configuration"
method: POST
path: "/v1/domains/{domainId}/account/{accountId}/sponsor"
tags: ["Gas station"]
---

# Create a sponsor configuration

`POST /v1/domains/{domainId}/account/{accountId}/sponsor`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/account/{accountId}/sponsor`
- Auth: HTTP bearer

## Path parameters

- `domainId` string, required
- `accountId` string, required

## Request body

- GasStationCreateSponsorDto
  - `type` 'domain' | 'account' | 'none', required: Type of sponsorship
  - `accountIds` string[]: Array of account UUIDs to sponsor
  - `includeSubDomains` boolean, required: Include subdomains in sponsorship
  - `alertLimit` GasStationAlertLimitDto[], required: Alert thresholds per ticker
    - `tickerId` string, required: Ticker/token UUID
    - `amount` string, required: Alert threshold amount
  - `userId` string: UUID of the user performing the action; recorded on the audit trail. Optional — only honored when the caller is a service principal; otherwise the authenticated user from the JWT is used.

## Response `201`

Sponsor created

- GasStationSponsorCreatedResponseDto
  - `id` string, required
  - `status` string, required
  - `createdAt` string, required

## Other responses

- `400`: Bad request
- `409`: Sponsor already exists

---

[API](https://skmtc.dev/ripple/apis/ripple-custody-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-custody-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-custody-api/revisions/c6f0ad6b70c0?raw)