Edit a contact at a partner

PATCH https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/contact/{contactId}

Edit a person on a partner's Relationship Hub contact list; fields you leave out stay as they are. `partnershipId` is the partnership id from ListPrmPartnerships, and `contactId` the contact's `id` from ListPrmOrgPartnerContacts with `partnershipIds`, or, when it has none, its plain email (not URL-encoded). Changing the email of a contact already in the CRM is refused with 400, and nothing is saved. Setting `role` pins it, so later title changes no longer re-infer it. With `syncToCrm` the contact's name and title, never its phone or LinkedIn, are pushed to the partnership's linked Salesforce Account, only the non-empty values that changed; with no linked Salesforce Account nothing is pushed.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
partnershipId path string yes Partnership ID
contactId path string yes Contact id, or the email of a contact without one

Request Body

Required. Content-Type: application/json · Schema: UpdatePrmPartnerContactInput

UpdatePrmPartnerContactInput fields:

FieldTypeRequiredDescription
email string no
firstName string no
lastName string no
linkedinUrl string no
phone string no
role PrmContactRole no
syncToCrm boolean no SyncToCrm pushes the edit to the Salesforce Contact afterwards.
title string no

Responses

200 — OK

Content-Type: application/json · Schema: PrmPartnerHubContactWriteResult

PrmPartnerHubContactWriteResult fields:

FieldTypeRequiredDescription
contact PartnerContact no
sync SyncPrmPartnerContactsResult no

PartnerContact fields:

FieldTypeRequiredDescription
apolloId string no ApolloID is the Apollo.io person ID for re-enrichment.
crmContactId string no CrmContactID is the person's record under the linked CRM Account.
email string no Email is the contact's verified email address.
enrichedAt string no EnrichedAt is the RFC3339 timestamp of the last enrichment.
firstName string no
id string no ID is the partnership_contact row id. Empty until someone acted on the person (added, edited, synced, removed); address such a person by email.
invitationId string no InvitationID and InvitedAt describe the pending invitation when Portal is INVITED.
invitedAt string no
isPrimary boolean no IsPrimary indicates this is the highest-seniority partnership contact.
lastActivityAt string no LastActivityAt is the person's last sign-in to the partner portal.
lastName string no
linkedinUrl string no LinkedinURL is the contact's LinkedIn profile URL.
name string no Name is the contact's full name.
ownDomain boolean no OwnDomain marks a person on the ISV's own email domain. Such rows are returned only with includeOwnDomain and are never synced, invited or made champion.
phone string no
portal PrmContactPortalStatus no
role PrmContactRole no
seniority string no Seniority is the contact's seniority level (e.g., "vp", "director", "manager", "ic").
source PrmContactSource no
syncError string no SyncError is the CRM's error from the last failed sync, verbatim.
syncStatus PrmContactSyncStatus no
title string no Title is the contact's job title/role (e.g., "VP of Partnerships").

SyncPrmPartnerContactsResult fields:

FieldTypeRequiredDescription
queued array<string> no
skipped array<PrmPartnerHubContactRowResult> no

PrmPartnerHubContactRowResult fields:

FieldTypeRequiredDescription
email string no
message string no
status string no Status is ADDED, EXISTING or INVALID for an import; SKIPPED for a sync.

400 — Bad request error

Content-Type: application/json

404 — Contact not found

Content-Type: application/json

Example

The request bodies are this operation's documented examples; the response and error bodies are generated from its schema. Substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X PATCH 'https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/contact/{contactId}' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "VP Alliances",
  "role": "EXECUTIVE"
}'

Response — 200

{
  "contact": {
    "apolloId": "01H0000000000000000000",
    "crmContactId": "01H0000000000000000000",
    "email": "buyer@example.com",
    "enrichedAt": "string",
    "firstName": "Acme Corp",
    "id": "01H0000000000000000000",
    "invitationId": "01H0000000000000000000",
    "invitedAt": "2026-01-31T12:00:00Z",
    "isPrimary": true,
    "lastActivityAt": "2026-01-31T12:00:00Z",
    "lastName": "Acme Corp",
    "linkedinUrl": "https://example.com"
  },
  "sync": {
    "queued": [
      "string"
    ],
    "skipped": [
      {
        "email": "buyer@example.com",
        "message": "string",
        "status": "string"
      }
    ]
  }
}

Error — 400

"string"

View as Markdown · API reference overview

Spotted something wrong or out of date on this page? Tell us and we'll correct it.