---
schema_version: "1"
id: 0e1260f14319ef252329553f1f82080202a0b0e20eadb593362a6ea0aee253b9
title: OpportunityTeamMember
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_opportunityteammember.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_opportunityteammember.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 5e72a12bf3a1e7ef5db855feb2c9b8dc5bd1b23e2b809ea1cf15e3df818f61dc
description: Represents a User on the opportunity team of an Opportunity.
---
# OpportunityTeamMember

Represents a User on the opportunity team of an Opportunity.

See also UserTeamMember, which represents a User who is on the default Opportunity team of another user.

## Supported Calls

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

## Fields

<table class="featureTable sort_table" summary="">


          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d1360300e101">Field</th>

              <th class="featureTableHeader  " id="d1360300e104">Details</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">IsDeleted</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">boolean</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Defaulted on create, Filter</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Indicates whether the object has been moved to the Recycle Bin (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). Label is <strong class="ph b">Deleted</strong>.</dd>


                </dl>

                <div class="box message info">
                  <div class="inner">
                    <div class="bd">
                      <div class="media">
                        <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png" alt="Note">
                        <div class="mediaBd">
                          <h4 class="mbs">Note</h4>
                          <p>An OpportunityTeamMember that is deleted isn’t moved to the Recycle Bin and can’t be undeleted, unless the record was cascade-deleted when deleting a related Opportunity. For directly deleted OpportunityTeamMember records, don't use the <span class="keyword parmname">isDeleted</span> field to detect deleted records in SOQL queries. Instead, use <samp class="codeph nolang">getDeleted()</samp>.</p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">Name</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Sort</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">The team member name. This read-only field is available in API version 30.0 and
                    later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">OpportunityAccessLevel</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Restricted picklist</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Opportunity access level for this team member. Valid values:</dd>

                  <dd class="dd">
                    <ul class="ul bulletList">
                      <li class="li"><span class="keyword parmname">Read</span></li>

                      <li class="li"><span class="keyword parmname">Edit</span></li>

                      <li class="li"><span class="keyword parmname">All</span></li>

                    </ul>
                    This field is supported in triggers, but not in workflows or validation rules. It’s
                    editable in API version 36.0 and later.
                  </dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">OpportunityId</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Required. ID of the Opportunity associated with this opportunity team. This field can’t be updated.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">PhotoURL</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">URL</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Sort, Group</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Read only. Retrieves the users Chatter photo URL. This field is available in API
                    version 32.0 and later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">TeamMemberRole</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">picklist</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter, Nillable, Update</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Role that the team member has on the opportunity. The org’s admin sets the valid
                    values in the Opportunity Team Roles picklist. Label is <strong class="ph uicontrol">Team
                      Role</strong>.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">Title</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">string</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Filter, Nillable, Sort, Group</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Read only. Retrieves the user’s title. This field is available in API version 36.0 and
                    later.</dd>


                </dl>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d1360300e101" data-title="Field"><span class="keyword parmname">UserId</span></td>

              <td class="entry" headers="d1360300e104" data-title="Details">
                <dl class="dl detailList">

                  <dt class="dt dlterm">Type</dt>

                  <dd class="dd">reference</dd>



                  <dt class="dt dlterm">Properties</dt>

                  <dd class="dd">Create, Filter</dd>



                  <dt class="dt dlterm">Description</dt>

                  <dd class="dd">Required. ID of the User who is a member of the opportunity team. This field
                    can’t be updated.</dd>


                </dl>

              </td>

            </tr>

          </tbody>

        </table>

## Usage

If you create a record for this object and the OpportunityId and UserId combination matches an existing record, the system updates any modified fields and returns the existing record.

In the user interface, users can set up an opportunity team for the opportunities they own. The opportunity team includes other users that are working on the opportunity with them. This object is available only in organizations that have enabled team selling.

![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png)

#### Note

The behavior for changing ownership of opportunities is different using the user interface when the previous owner is on an opportunity team. For example, when you change the owner of an opportunity using the API, the previous owner's access becomes Read Only or the access specified in your organization-wide default for opportunities, whichever is greater. However, performing this same action in the user interface allows you to select the access level for the previous owner when the previous owner is on an opportunity team.

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

[OpportunityTeamMemberHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") (API version 59.0)

History is available for tracked fields of the object.

#### See Also

- [UserTeamMember](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_userteammember.htm "Represents a single User on the default opportunity team of another User.")