Add Contact | Redpin | Documentation

Create one or more contact records for an existing customer account. This endpoint allows you to add authorized individuals or company representatives who can:

Manage the customer’s account
Receive account updates and notifications
Execute trades on behalf of the customer

Use this when a customer needs additional people with account access permissions.

Authentication: Bearer token required

Create one or more contact records for an existing customer account. This endpoint allows you to add authorized individuals or company representatives who can: - Manage the customer's account - Receive account updates and notifications - Execute trades on behalf of the customer Use this when a customer needs additional people with account access permissions. **Authentication:** [Bearer token required](/api-guide/getting-started/authentication#oauth-20-authentication)

Authentication

AuthorizationBearer

OAuth 2.0 Bearer token authentication. This API uses OAuth 2.0 Client Credentials flow. Please refer to the Authentication section for detailed information on how to obtain and use your OAuth credentials.

Path parameters

customerIdstringRequired

The unique identifier you received from the Get Customer’s ID API response.

Request

This endpoint expects a list of objects.

first_namestringRequired

First name of this contact person

last_namestringRequired

Last name of this contact person

date_of_birthdateRequired

DOB of contact person in ISO 8601 format (YYYY-MM-DD)

emailstringRequiredformat: "email"

Email address of the contact person

mobile_numberstringRequired

Contact mobile number in E.164 international format (e.g., +14155552671).

primary_contactbooleanRequired

Primary contact for the customer account

authorize_to_tradebooleanRequired

Whether the customer is authorised to trade with us

addressobjectRequired

middle_namestringOptional

Middle name of this contact person

employment_statusstringOptional

Employment status of the contact. See Employment Status API for a list of supported values.

industrystringOptional

Employment industry of the contact. See Employment Industry API for a list of supported values.

nationalitystringOptional

Nationality of the contact

phone_numberstringOptional

Contact phone number

proof_of_identityobjectOptional

Supporting identification documents for the contact. Provide exactly one document type per contact.

Response

Created. Contact added successfully.

customer_idstring or null

Identifier of the customer this contact belongs to.

1	curl -X POST https://sandbox.currenciesdirect.com/v1/customers/{customerId}/contacts \
2	-H 'Content-Type: application/json' \
3	-H 'Accept: application/json' \
4	-H 'Authorization: Bearer {access-token}' \
5	-d '{
6	"contact": {
7	"first_name": "Carlos",
8	"middle_name": "John",
9	"last_name": "Lopez",
10	"date_of_birth": "1980-02-14",
11	"employment_status": "Full-time",
12	"industry": "Technology and Software",
13	"nationality": "United States of America",
14	"email": "carlos@hotmail.com",
15	"phone_number": "(020)123456789",
16	"mobile_number": "+44-987654321",
17	"primary_contact": true,
18	"authorize_to_trade": true,
19	"address": {
20	"unit_number": "321",
21	"street_number": "468",
22	"street": "Bissonnet Plaza, El Campo",
23	"street_type": "Plaza",
24	"post_code": "77023",
25	"city": "Houston",
26	"civic_number": "741",
27	"state": "Texas",
28	"country": "USA"
29	},
30	"proof_of_identity": {
31	"passport": {
32	"number": "12345",
33	"name_at_citizenship": "Lopez",
34	"family_name_at_birth": "Lopez",
35	"place_of_birth": "Houston, USA",
36	"expiry_date": "2025-09-30",
37	"issuing_country": "USA"
38	}
39	}
40	}
41	}'

1	{
2	"customer_id": "0005924291"
3	}

Authentication

Path parameters

Request

Response

Errors