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

Bearer authentication of the form Bearer <token>, where token is your auth token.

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_birthstringRequiredformat: "date"

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	import requests
2
3	url = "https://sandbox.currenciesdirect.com/v1/customers/0005924291/contacts"
4
5	payload = [
6	{
7	"first_name": "Carlos",
8	"last_name": "Lopez",
9	"date_of_birth": "1980-02-14",
10	"email": "carlos@hotmail.com",
11	"mobile_number": "+44-987654321",
12	"primary_contact": True,
13	"authorize_to_trade": True,
14	"address": {
15	"post_code": "77023",
16	"city": "Houston",
17	"country": "USA",
18	"unit_number": "",
19	"street_number": "468",
20	"street": "Bissonnet Plaza, El Campo",
21	"street_type": "Plaza",
22	"civic_number": "",
23	"state": "Texas"
24	},
25	"middle_name": "",
26	"employment_status": "Full-time",
27	"industry": "Technology and Software",
28	"nationality": "United States of America",
29	"phone_number": "(020)123456789",
30	"proof_of_identity": { "passport": {
31	"number": "12345",
32	"place_of_birth": "Houston, USA",
33	"expiry_date": "2025-09-30",
34	"issuing_country": "USA",
35	"name_at_citizenship": "Lopez",
36	"family_name_at_birth": "Lopez"
37	} }
38	}
39	]
40	headers = {
41	"Authorization": "Bearer <token>",
42	"Content-Type": "application/json"
43	}
44
45	response = requests.post(url, json=payload, headers=headers)
46
47	print(response.json())

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

Authentication

Path parameters

Request

Response

Errors