Skip to main content
POST
Create a merchant representative
Associate a person with a merchant as someone legally authorized to bind that merchant in transactions.
The person must already exist in Tilta. Create them with the Create person endpoint first, then reference their person_external_id here.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a merchant.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Body

application/json
person_external_id
string
required

Unique identifier of a person.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Response

person_external_id
string
required
merchant_external_id
string
required
status
enum<string>
required
Available options:
PENDING_VERIFICATION,
VERIFYING,
NEEDS_REVIEW,
MANUAL_REVIEW,
REJECTED,
APPROVED,
SUSPENDED,
INACTIVE