Opportunity Roles

Opportunity Roles Endpoint Reference

Leads are linked to opportunities via the intermediate opportunityRole object.

Describe

Like opportunities, a describe call and CRUD operations is exposed for opportunity roles.

Query

You’ll notice that both dedupeFields and searchableFields are a little different from opportunities.  dedupeFields actually provides a compound key, where all three of externalOpportunityId, leadId, and role are required.  Both the opportunity and lead link by the id fields need to already exist in the destination instance, in order for record creation to succeed.  For searchableFields, marketoGUID, leadId, and externalOpportunityId are all valid for queries on their own and use a pattern identical to Opportunities, but there is an additional option of using the compound key to query, which requires submitting a JSON object via POST, with the additional query paremeter “_method=GET”:

This produces the same type of response as a standard GET query, it simply has a different interface for making the request.

Create and Update

Opportunity roles have the same interface for creating and updating records as opportunities.