---
title: "Create Moov Account"
method: POST
path: "/billing/account"
tags: ["Billing", "billing"]
---

# Create Moov Account

`POST /billing/account`

Create a Moov payment account for the customer.

Requires simplified business information (name, address, phone) and a ToS token.
The ToS token should be obtained by the frontend using Moov.js.

Admin only endpoint.

## Request body

- CreateMoovAccountRequest — Request to create a Moov account with simplified business info.
  - `business_name` string, required
  - `address` MoovAddress, required — Physical address for Moov account.
    - `address_line1` string, required
    - `address_line2` string, nullable
    - `city` string, required
    - `state_or_province` string, required
    - `postal_code` string, required
    - `country` string
  - `phone` PhoneNumber, required — Phone number with country code.
    - `number` string, required
    - `country_code` string
  - `email` string, email, required
  - `terms_of_service_token` string, required — Token accepting Terms of Service

## Response `201`

Successful Response

- CreateMoovAccountResponse — Response after creating Moov account.
  - `account_id` string, uuid, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)
