Update a partner contact

Updates a contact's details and links CRM records to it. Requires partners_edit permission.

Only the fields you send are changed. Sending null clears title, linkedin_url or phone_number; name cannot be cleared. The email address cannot be changed.

name and phone_number belong to the person rather than to this partner. Once the person has activated their Lasso login, or is also a contact or team member in another Lasso account, a request that changes either is refused with 422 and NOT_EDITABLE. Sending the value they already have is accepted, so a sync that always sends the full profile keeps working.

CRM IDs are added, never replaced or removed: a different ID from the one this contact already holds for that CRM, or one another contact holds, is a 409; an empty one is a 422 with CANNOT_BE_CLEARED.

As with create, a key without partners_read gets only the contact's slug back.

patch/partners/{identifier}/contacts/{contact_identifier}

Request

Base URL: https://api.lassotech.com/api/v1/rest
URL: https://api.lassotech.com/api/v1/rest/partners/{identifier}/contacts/{contact_identifier}
Auth: API key in header x-lasso-access-token

Path parameters

identifierstring required

Partner identifier, interpreted according to by

contact_identifierstring required

The contact's slug. by applies to the partner identifier only.

Query parameters

by'slug' | 'id' | 'lasso_key' | 'name' | 'external'

How to read the partner identifier in the path. See Resource Lookup.

external_system_typestring

Required when by=external. e.g. HUBSPOT, SALESFORCE, PIPEDRIVE

external_object_typestring

Required when by=external (optional for a Salesforce partner). e.g. company, deal, opportunity, account

Request body

namestring

phone_numberstring nullable

titlestring nullable

linkedin_urlstring nullable

hubspot_contact_idstring

salesforce_contact_idstring

pipedrive_person_idstring

Response

Contact updated, or unchanged if there was nothing to change

Example response

{
  "contact": {
    "slug": "PC-A1B2C3",
    "partner_slug": "acme-corp",
    "name": "Jane Smith",
    "email": "jane@acme.com",
    "title": "Finance Manager",
    "role": "finance_legal_contact",
    "external_ids": [
      {
        "system_type": "HUBSPOT",
        "object_type": "company",
        "identifier": "123"
      }
    ]
  }
}

Changes

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