---
title: "Signup a customer"
method: POST
path: "/v1/signup_page/signup_customer"
tags: ["signup"]
---

# Signup a customer

`POST /v1/signup_page/signup_customer`

## Request

- Base URL: `https://checkout-api.frisbii.com`
- URL: `https://checkout-api.frisbii.com/v1/signup_page/signup_customer`
- Auth: none declared

## Request body

- CreateCustomerSignup
  - `email` string: Customer email. Validated against RFC 822.
  - `address` string: Customer address
  - `city` string: Customer city
  - `country` string: Customer country in ISO 3166-1 alpha-2
  - `phone` string: Customer phone number
  - `company` string: Customer company
  - `coupons` string[]: Coupons
  - `language` string: Customer language
  - `signup_page_handle` string, required: Signup page handle. Max length 255 with allowable characters [a-zA-Z0-9_.-@].
  - `product_handle` string, required: Product handle. Max length 255 with allowable characters [a-zA-Z0-9_.-@].
  - `account_id` string, required: Account ID. Max length 255 with allowable characters [a-zA-Z0-9_.-@].
  - `first_name` string: Customer first name
  - `last_name` string: Customer last name
  - `postal_code` string: Customer postal code
  - `vat_number` string: Customer VAT number
  - `plan_quantity` integer: Plan quantity. This parameter allows customers to customize the number of subscriptions that can be purchased simultaneously. This parameter is taken into account only if the product's configuration allows quantity overwriting; otherwise, the quantity specified in the subscription plan is used.
  - `subscription_start` string: Date and time on the form `yyyy-MM-dd`, `yyyyMMdd`, `yyyy-MM-ddTHH:mm` and `yyyy-MM-ddTHH:mm:ss` from which the subscription is eligible to schedule first invoice. If no time part is given start of day will be used. A start date in the past can be used, but no more than one period length in the past. A start date in the past can result in an instant invoice for a past billing period start. Default value is current date and time.
  - `custom_fields` object: Key/value pairs for the custom fields of the given hosted page product
  - `consent_accepted` boolean: Flag indicating whether the customer has accepted the consent definitions and the policies, if presented on the signup page.

## Response `200`

Successful operation

- CustomerSignup
  - `session_id` string

## Other responses

- `400`: Invalid request, see error codes at https://api.frisbii.com/v1/error_codes
- `401`: None or invalid credentials provided in access to secured resource
- `403`: Not authorized to perform resource operation
- `404`: Resource or referenced resource not found, see error codes at https://api.frisbii.com/v1/error_codes
- `500`: Internal service error, error is reported automatically to Frisbii

---

[API](https://skmtc.dev/frisbii/apis/frisbii-checkout-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-checkout-api/revisions/43015ffd9dbb?raw)