Salesly API
API Reference

Update a contact

PUT
/contacts/{identifier}

Authorization

x-api-key<token>

Your tenant API key

In: header

Request Body

application/jsonRequired
namestring
typestring
emailstring
Format: "email"
is_personboolean
cifstring
phonestring
webstring
ibanstring
commentsstring
usersarray<string>
locationobject
extra_fieldsobject

Replaces all existing custom contact values. Include every value you want to keep; omit this property to leave custom fields unchanged. Use exact configured field names, not labels or IDs, including accents. Text fields take strings; selection fields take arrays of option labels. For a field named "Originació" (label "ORIGINACIO"), send {"Originació": ["Web"]}. The field must exist in this workspace. Unknown field names are silently ignored. Do not send null. See the Getting Started guide for examples and current limitations.

Path Parameters

identifier
Required
string

Accepts any of the following (matched in order): numeric ID, name, email, or CIF/tax identifier. The first matching contact is returned. Use the numeric ID for unambiguous lookups.

curl -X PUT "https://rest.salesly.app/api/v1/developers/contacts/string" \
  -H "x-api-key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "type": "string",
    "email": "[email protected]",
    "is_person": true,
    "cif": "string",
    "phone": "string",
    "web": "string",
    "iban": "string",
    "comments": "string",
    "users": [
      "[email protected]"
    ],
    "location": {
      "primary": 0,
      "direction": "string",
      "city": "string",
      "postal": "string",
      "country": "string",
      "latitude": "string",
      "longitude": "string",
      "extra_info": "string"
    },
    "extra_fields": {
      "Originació": [
        "Web"
      ]
    }
  }'

Contact updated

{
  "data": {
    "id": 0,
    "name": "string",
    "email": "[email protected]",
    "type": "client",
    "is_person": true,
    "cif": "string",
    "phone": "string",
    "web": "string",
    "iban": "string",
    "comments": "string",
    "extra_fields": {},
    "location": {
      "id": 0,
      "primary": 0,
      "direction": "string",
      "city": "string",
      "postal": "string",
      "country": "string",
      "latitude": "string",
      "longitude": "string",
      "extra_info": "string"
    },
    "users": [
      {
        "id": 0,
        "name": "string",
        "email": "[email protected]"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}

Create a contact

Previous Page

Delete a contact

Next Page