OpportunityContactRole

Represents the role that a Contact plays on an Opportunity.

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), update(), upsert()

Fields

Field	Details
ContactId	Type reference Properties Create, Filter, Group, Sort, Update Description ID of an associated Contact. The API applies user access rights to the associated Opportunity for this object, but not to the associated Contact. The API may return rows from a query on this object that include this field’s values for contacts to which the user does not have sufficient access rights. It may also return values for this field for contacts that have been deleted. In either case, the client must perform a query on the contact table for this field’s value to determine whether the Contact is accessible to the user and has not been deleted.
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the record has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
IsPrimary	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the associated Contact plays the primary role on the Opportunity (`true`) or not (`false`). Each Opportunity has only one primary contact. Label is Primary.
OpportunityId	Type reference Properties Create, Filter, Group, Sort, Description Required. ID of an associated Opportunity. This field is non-nullable, and it cannot be updated. You must provide a value for this field when creating new records. You can’t change it after it has been created.
Role	Type picklist Properties Create, Filter, Group, Sort, Nillable, Update Description Name of the role played by the associated Contact on the Opportunity, such as Business User or Decision Maker.

Usage

Records of this object type appear in the user interface on the Opportunity detail page. Like most other objects, records of this object type have their own unique ID that you use when updating or deleting records.

Although allowed, we do not recommend that you create multiple relationships between the same Opportunity and a Contact.