---
title: "ContactDetails"
method: POST
path: "/workspaces/{workspace_id}/customer/contact_detail"
tags: ["subscription"]
---

# ContactDetails

`POST /workspaces/{workspace_id}/customer/contact_detail`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/customer/contact_detail`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/customer/contact_detail/post.ts> (a function with typed inputs; its response is checked against the schema)

Allows to save contact details.

## Path parameters

- `workspace_id` integer, required

## Request body

- SubscriptionContactDetailRequest
  - `company_address` string, required
  - `company_city` string
  - `company_name` string, required
  - `contact_email` string, required
  - `contact_person` string
  - `country_id` integer, required
  - `country_subdivision_id` integer: CountrySubdivisionID is the ID of the country subdivision (state in USA) This field is required if country_id == 235 (United states)
  - `subDivision` ModelsSubdivision
    - `company_id` integer
    - `country_id` integer
    - `country_subdivision_id` integer
    - `iso_code` string
    - `name` string
  - `tax_number` string
  - `zip_code` string: ZIPCode field is required if country_id == 235 (United states)

## Response `200`

Returns subscription data.

- ModelsContactDetail
  - `company_address` string
  - `company_city` string
  - `company_name` string
  - `contact_detail_id` integer
  - `contact_email` string
  - `contact_person` string
  - `country_id` integer
  - `country_subdivision_id` integer
  - `created_at` string
  - `customer_id` integer
  - `is_eu_resident` boolean
  - `updated_at` string
  - `user_id` integer
  - `vat_number` string
  - `vat_number_valid` boolean: DEPRECATED
  - `vat_number_validated_at` string: DEPRECATED
  - `zip_code` string

## Other responses

- `400`: Possible error messages: * JSON is not valid * pricing\_plan\_id required * the company\_name field is required * the company\_address field is required * Missing e-mail * Invalid e-mail: * country\_id invalid * invalid country\_subdivision\_id * invalid country/subdivision combination * the country\_subdivision\_id field is required for US customers * the zip\_code field is required for US customers * invalid zip\_code
- `403`: Admin permissions required.
- `500`: Internal Server Error

---

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