List the people enrichment suggests at one partner company

GET https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/suggestedContact

List the people company enrichment (Apollo or PDL) suggests at one partner company: name, email, job title, LinkedIn URL, seniority, and which one is the primary (highest-seniority) contact. Needs partners.read. `partnershipId` is the partnership id from ListPrmPartnerships. These come from the company-enrichment record for the partner, so a partnership Fours has not enriched returns an empty array. An empty result is normal and common; it is not a failure: do not retry it, and do not report it as "this partner has no contacts" without saying where the list comes from. These are suggestions, not the partnership's contacts. The people the partnership already has (its CRM Account's contacts, its partner-portal users, its deal registrations' team and those added in the hub) are ListPrmOrgPartnerContacts with `partnershipIds`. The partner's champion is `info.partnerChampionContact` on GetPrmPartnership, and ListPrmInvitations says who has been written to. Here "partner" means a company in your own partner program, addressed by its partnership id. Do not confuse it with GetPartnerContacts, which returns cloud-provider representatives (AWS, Azure, GCP) for a customer company addressed by email domain.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
partnershipId path string yes Partnership ID

Responses

200 — OK

Content-Type: application/json

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").

404 — No such partnership in this organization

Content-Type: application/json

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X GET 'https://api.suger.cloud/ai/org/{orgId}/prm/partnership/{partnershipId}/suggestedContact' \
  -H "Authorization: Bearer $SUGER_TOKEN"

Response — 200

[
  {
    "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"
  }
]

Error — 404

"string"

View as Markdown · API reference overview

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