---
title: "Create a new gateway account"
method: POST
path: "/v1/api/accounts"
tags: ["Gateway accounts"]
---

# Create a new gateway account

`POST /v1/api/accounts`

## Query parameters

- `degatewayification` boolean

## Request body

- GatewayAccountRequest
  - `allow_apple_pay` boolean — Set to 'true' to enable Apple Pay for this account
  - `allow_google_pay` boolean — Set to 'true' to enable Google Pay for this account
  - `analytics_id` string — Google Analytics (GA) unique ID for the GOV.UK Pay platform
  - `description` string — Some useful non-ambiguous description about the gateway account
  - `payment_provider` string — The payment provider for which this account is created
  - `requires_3ds` boolean — Set to 'true' to enable 3DS for this account
  - `send_payer_email_to_gateway` boolean — Set to 'true' to enable send payer's email for this account
  - `send_payer_ip_address_to_gateway` boolean — Set to 'true' to enable send payer's IP address for this account
  - `service_id` string
  - `service_name` string
  - `type` string — Account type for this provider (test/live)

## Response `201`

Created

- CreateGatewayAccountResponse
  - `analytics_id` string
  - `description` string
  - `external_id` string
  - `gateway_account_id` string
  - `links` object[]
  - `requires_3ds` boolean
  - `send_payer_email_to_gateway` boolean
  - `send_payer_ip_address_to_gateway` boolean
  - `service_name` string
  - `type` string

## Other responses

- `422` — Missing required fields or invalid values

---

[API](https://skmtc.net/government-digital-service/apis/connector-api.md) · [All operations](https://skmtc.net/government-digital-service/apis/connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/government-digital-service/connector-api/revisions/62149e57992f/schema)