Add Contact | Redpin | Documentation

curl -X POST https://sandbox.currenciesdirect.com/v1/customers/{customerId}/contacts \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}' \
  -d '{
    "contact": {
      "first_name": "Carlos",
      "middle_name": "John",
      "last_name": "Lopez",
      "date_of_birth": "1980-02-14",
      "employment_status": "Full-time",
      "industry": "Technology and Software",
      "nationality": "United States of America",
      "email": "carlos@hotmail.com",
      "phone_number": "(020)123456789",
      "mobile_number": "+44-987654321",
      "primary_contact": true,
      "authorize_to_trade": true,
      "address": {
        "unit_number": "321",
        "street_number": "468",
        "street": "Bissonnet Plaza, El Campo",
        "street_type": "Plaza",
        "post_code": "77023",
        "city": "Houston",
        "civic_number": "741",
        "state": "Texas",
        "country": "USA"
      },
      "proof_of_identity": {
        "passport": {
          "number": "12345",
          "name_at_citizenship": "Lopez",
          "family_name_at_birth": "Lopez",
          "place_of_birth": "Houston, USA",
          "expiry_date": "2025-09-30",
          "issuing_country": "USA"
        }
      }
    }
  }'

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.

Response

Created. Contact added successfully.

customer_idstring

Identifier of the customer this contact belongs to.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

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