Contacts

Create contact

Create a contact person record. Email addresses and phone numbers are unique across contacts; duplicates are rejected with 409.

post/v1/contacts

Request

Base URL
https://contacts-api.paymongo.com
URL
https://contacts-api.paymongo.com/v1/contacts
Auth
HTTP basic

Request body

descriptionstring

first_namestring required

last_namestring required

metadataobject

middle_namestring

phonestring[]

rolestring

suffixstring

Example request

{
  "address": {
    "city": "Makati",
    "country": "PH",
    "line_1": "123 Ayala Ave",
    "line_2": "Unit 4B",
    "postal_code": "1226",
    "province": "Metro Manila"
  },
  "description": "Lead from summer campaign",
  "email": [
    {
      "email": "juan@example.com",
      "type": "TO"
    }
  ],
  "first_name": "Juan",
  "last_name": "Dela Cruz",
  "middle_name": "Protacio",
  "phone": [
    "+639171234567"
  ],
  "role": "CEO",
  "suffix": "Jr."
}

Response

Created

has_moreboolean

Example response

{
  "data": {
    "attributes": {
      "address": {
        "city": "Makati",
        "country": "PH",
        "line_1": "123 Ayala Ave",
        "line_2": "Unit 4B",
        "postal_code": "1226",
        "province": "Metro Manila"
      },
      "created_at": "2026-07-01 10:00:00+00:00",
      "description": "Lead from summer campaign",
      "email": [
        {
          "email": "juan@example.com",
          "type": "TO"
        }
      ],
      "first_name": "Juan",
      "last_name": "Dela Cruz",
      "middle_name": "Protacio",
      "phone": [
        "+639171234567"
      ],
      "role": "CEO",
      "status": "active",
      "suffix": "Jr.",
      "updated_at": "2026-07-01 10:00:00+00:00"
    },
    "id": "cnt_0123456789abcdef01234567"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.