Skip to Content
TillorManual
Identity document scans

Create contact from identity document scan

Access

Member of the organization with this permission:

  • identity-document-scans:write

An API key with scopes also needs the permission among its scopes.

POST
/orgs/{organizationId}/identity-document-scans/{id}/create-contact

Creates a contact for the given customer using MRZ-derived scan fields (where present), assigns the scan to that customer if needed, and links the scan to the new contact in one step. The scan must not already be linked to another customer or to a contact. Returns 400 if data is insufficient.

Authorization

ApiKeyAuth
headerx-api-key<token>

API key for authentication

Path Parameters

organizationId*string

The ID or slug of the organization

id*string
Length1 <= length

Request Body

application/json
  1. body
customerId*string
Length1 <= length

Response Body

OK

application/json
  1. response
Example Request
curl -X POST 'https://api.tillor.eu/orgs//identity-document-scans/string/create-contact' \  -H 'Content-Type: application/json' \  -d '{  "customerId": "string"}'
Example Response
null

Create customer from identity document scan POST

Creates a customer from MRZ-derived scan fields, applies extra fields where possible, and links the scan. Returns 400 if the scan is already linked or has no given name.

Unlink identity document scan POST

Removes the customer and contact link from an identity document scan. The scan itself is not deleted.