---
title: "Create Contact"
method: POST
path: "/integration/contacts"
tags: ["integration"]
---

# Create Contact

`POST /integration/contacts`

## Request

- Base URL: `https://app.orla.finance/api`
- URL: `https://app.orla.finance/api/integration/contacts`
- Auth: HTTP bearer

## Request body

- ContactCreate
  - `address` string
  - `addresses` ContactAddressIn[]
    - `address` string
    - `chain` string, nullable
    - `details` string
    - `is_primary` boolean
    - `label` string
    - `network` string, nullable
    - `requisites` union
      - SepaRequisites
        - `bank_country` string
        - `bic` string
        - `city` string
        - `country` string
        - `holder` string, required
        - `holder_kind` 'company' | 'individual'
        - `iban` string, required
        - `postcode` string
        - `scheme` 'sepa', required
        - `state` string
        - `street` string
      - UkRequisites
        - `account_no` string, required
        - `bank_country` string
        - `city` string
        - `country` string
        - `holder` string, required
        - `holder_kind` 'company' | 'individual'
        - `postcode` string
        - `scheme` 'uk', required
        - `sort_code` string, required
        - `state` string
        - `street` string
      - UsAchRequisites
        - `account_no` string, required
        - `account_type` 'checking' | 'savings'
        - `bank_country` string
        - `city` string
        - `country` string
        - `holder` string, required
        - `holder_kind` 'company' | 'individual'
        - `postcode` string
        - `routing_number` string, required
        - `scheme` 'us_ach', required
        - `state` string
        - `street` string
      - SwiftRequisites: The catch-all corridor: everything that is neither SEPA, UK nor US ACH.
        - `account_no` string, required
        - `bank_country` string
        - `bank_name` string
        - `bic` string, required
        - `city` string
        - `country` string
        - `holder` string, required
        - `holder_kind` 'company' | 'individual'
        - `postcode` string
        - `scheme` 'swift', required
        - `state` string
        - `street` string
      - PartnerRequisites: A payout route through the partner behind accounts inside Orla (Noah).
        - `bank_country` string
        - `city` string
        - `country` string
        - `fiat_currency` string, required
        - `fields` object
        - `holder` string, required
        - `holder_kind` 'company' | 'individual'
        - `identifier` string, required
        - `method` string, required
        - `postcode` string
        - `scheme` 'partner', required
        - `state` string
        - `street` string
  - `billing_email` string, nullable
  - `cc_emails` string[], nullable
  - `compliance` string
  - `country` string
  - `email` string
  - `identity_id` string, uuid, nullable
  - `kind` string
  - `name` string, required
  - `note` string
  - `phone` string
  - `reg_number` string
  - `save_to_book` boolean
  - `tags` string[]
  - `tax_id` string
  - `whitelisted` boolean

## Response `201`

Successful Response

- ContactOut
  - `address` string
  - `addresses` ContactAddressOut[], required
    - `address` string, required
    - `chain` string, nullable, required
    - `details` string
    - `id` string, uuid, required
    - `is_primary` boolean
    - `label` string, required
    - `network` string, nullable
    - `requisites` object, nullable
  - `billing_email` string
  - `cc_emails` string[]
  - `collection_tone` string, nullable
  - `compliance` string, required
  - `country` string
  - `email` string
  - `id` string, uuid, required
  - `identity_id` string, uuid, nullable
  - `kind` string, required
  - `last_paid_on` string, date, nullable
  - `last_paid_usd` string, nullable
  - `name` string, required
  - `note` string, required
  - `phone` string
  - `reg_number` string
  - `screening` CounterpartyScreeningSummary: The one-line verdict that rides on `ContactOut` for the card and the phone: enough to draw the traffic light, not the whole record.
    - `checked_at` string, date-time, required
    - `hits_more` integer
    - `hits_open` integer, required
    - `registry_checked` boolean, required
    - `registry_found` boolean, nullable
    - `verdict` string, nullable, required
  - `tags` string[]
  - `tax_id` string
  - `tax_id_expected_format` string
  - `whitelist_reset` boolean
  - `whitelisted` boolean, required

## Other responses

- `202`: The write waits for a check or a review of the book's policy.
- `422`: Validation Error

---

[API](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors.md) · [All operations](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/llms.txt) · [OpenAPI document](https://skmtc.dev/orla/apis/orla-api-agent-and-integration-doors/revisions/62d5d0a3ba7a?raw)