---
updatedAt: 2026-04-29T19:31:01.000Z
agentTools:
  projectIndex: https://docs.vopay.com/llms.txt
---

# gcm/recipient-contacts/add

Add a recipient contact. All name, address, and phone fields must comply with Mastercard Cross-Border Services Data Quality Standards (effective April 20, 2026).

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "2.0",
    "title": "Global Cash Management",
    "description": "The Global Cash Management API allows you to manage your recipient contacts, delivery channels, and delivery methods.",
    "contact": {
      "name": "API Support",
      "email": "help@vopay.com"
    }
  },
  "paths": {
    "/gcm/recipient-contacts/add": {
      "post": {
        "description": "Add a recipient contact. All name, address, and phone fields must comply with Mastercard Cross-Border Services Data Quality Standards (effective April 20, 2026).",
        "summary": "gcm/recipient-contacts/add",
        "tags": [
          "Recipient Contact Endpoints"
        ],
        "operationId": "RecipientContactsAddPOST",
        "deprecated": false,
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "AccountID": {
                    "description": "Your account ID",
                    "type": "string"
                  },
                  "Key": {
                    "description": "API key for the account",
                    "type": "string"
                  },
                  "Signature": {
                    "description": "Hashed signature for the request",
                    "type": "string"
                  },
                  "EmailAddress": {
                    "description": "The email address of the recipient contact",
                    "type": "string"
                  },
                  "ContactClientType": {
                    "description": "If the contact is an individual or business",
                    "type": "string"
                  },
                  "ClientAccountID": {
                    "description": "The client account ID the recipient belongs to",
                    "type": "string"
                  },
                  "RecipientContactID": {
                    "description": "The ID for the recipient contact",
                    "type": "string"
                  },
                  "BusinessName": {
                    "description": "Full legal business name of the recipient. Required if FirstName and LastName are not provided. Must be 2-60 characters and contain at least one letter. No abbreviations except standard suffixes (e.g. LLC, Ltd.).",
                    "type": "string"
                  },
                  "FirstName": {
                    "description": "First name of the individual recipient. Required if BusinessName is not provided. Must be 2-60 characters using only letters, spaces, commas, apostrophes, hyphens, and dots. No initials, acronyms, or company identifiers.",
                    "type": "string"
                  },
                  "LastName": {
                    "description": "Last name of the individual recipient. Required if BusinessName is not provided. Must be 2-60 characters using only letters, spaces, commas, apostrophes, hyphens, and dots. No initials, acronyms, or company identifiers.",
                    "type": "string"
                  },
                  "PhoneNumber": {
                    "description": "Phone number of the recipient. Digits only, 9-15 characters. No spaces or hyphens (e.g. 19998887777).",
                    "type": "string"
                  },
                  "Address1": {
                    "description": "Street address of the recipient. Must include a street name (e.g. 20 Longleat Drive). Numbers only are not accepted.",
                    "type": "string"
                  },
                  "Address2": {
                    "description": "The second address line of the recipient contact",
                    "type": "string"
                  },
                  "City": {
                    "description": "City of the recipient's address.",
                    "type": "string"
                  },
                  "Province": {
                    "description": "The province of the address",
                    "type": "string"
                  },
                  "PostalCode": {
                    "description": "The postal code of the address",
                    "type": "string"
                  },
                  "Country": {
                    "description": "Country of the recipient's address. Accepts full country name or ISO 3166-1 alpha-2 or alpha-3 code. Sanctioned countries are not accepted.",
                    "type": "string"
                  },
                  "DateOfBirth": {
                    "description": "Date of birth of the recipient in YYYY-MM-DD format (e.g. 1990-01-31).",
                    "type": "string"
                  },
                  "Nationality": {
                    "description": "The nationality specified using full country name or ISO 3166-1 alpha-2 or ISO 3166-1 alpha-3 code.",
                    "type": "string"
                  },
                  "Language": {
                    "description": "The language preference",
                    "type": "string"
                  },
                  "SourceOfIncome": {
                    "description": "The source of income of the recipient contact",
                    "type": "string"
                  },
                  "Occupation": {
                    "description": "The occupation of the recipient contact",
                    "type": "string"
                  },
                  "RelationshipWithBeneficiary": {
                    "description": "The sender's relationship to the recipient contact",
                    "type": "string"
                  }
                },
                "required": [
                  "AccountID",
                  "Key",
                  "Signature",
                  "EmailAddress",
                  "ContactClientType",
                  "PhoneNumber",
                  "Address1",
                  "City"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "Success",
                    "ErrorMessage",
                    "RecipientContactID"
                  ],
                  "properties": {
                    "Success": {
                      "type": "boolean",
                      "description": "True if the request was successful, false if it failed",
                      "example": true
                    },
                    "ErrorMessage": {
                      "type": "string",
                      "description": "Contains a description of the error if the request failed",
                      "example": ""
                    },
                    "RecipientContactID": {
                      "type": "integer",
                      "description": "The unique ID of the new recipient contact.",
                      "example": "test_recipient_contact"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://earthnode-dev.vopay.com/api/v2"
    }
  ]
}
```