---
title: Contact
slug: contact
description: Learn how to create or update contacts using a POST method and JSON object with this informative document. Discover the ease of creating new contacts and updating existing ones using the contact_uid. Includes a practical code example using cURL and highli
createdAt: 2023-09-28T14:53:39.264Z
---

Contacts can be created or updated via a POST method which accepts a JSON object describing the contact.

Contacts not found via contact\_uid will be created, and those that are found will be updated.

:::ApiMethodV2
```json
{
  "name": "Create or update a contact",
  "method": "POST",
  "url": "https://api.salesmachine.io/v1/contact",
  "description": " ",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "LSj2sm3EXH0152pxU5BC3",
        "language": "curl",
        "code": "\ncurl -X POST -H \"Content-Type: application/json\"   \\\n-d '{\"contact_uid\":\"123456\", \"params\" : { \"email\":\"elon@teslamotors.com\", \"name\":\"Elon Musk\", \"gender\":\"male\", \"mrr\": 99, \"account_uid\":\"78910\" }}' \\\n'https://api.successeve.com/v1/contact?api_token=<YOUR_API_TOKEN>'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "LSj2sm3EXH0152pxU5BC3"
  },
  "results": {
    "languages": [
      {
        "id": "S5jjN0VFSH4vsNqHidKwC",
        "language": "200",
        "customLabel": "",
        "code": "{status: \"success\"}"
      }
    ],
    "selectedLanguageId": "S5jjN0VFSH4vsNqHidKwC"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [],
    "bodyDataParameters": [
      {
        "name": "contact_uid",
        "kind": "required",
        "type": "string",
        "description": "The contact unique_id you have defined for the contact."
      },
      {
        "name": "params.email",
        "kind": "optional",
        "type": "string",
        "description": "Contact email",
        "children": []
      },
      {
        "name": "params.name",
        "kind": "optional",
        "type": "string",
        "description": "Contact fullname",
        "children": []
      },
      {
        "name": "params.account_uid",
        "kind": "optional",
        "type": "string",
        "description": "Unique id of a linked account",
        "children": []
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  }
}
```
:::

