--- schema_version: "1" id: 4244b2d2774f91416425a3bcb90360eb218bb29c148ab7cbd916a828857a3b64 title: PartnerNetworkRecordConnection collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_partnernetworkrecordconnection.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_partnernetworkrecordconnection.htm source_site: developer.salesforce.com content_type: documentation content_hash: 086bbab5858e70ff7cfc119df87ba63a1461b01b94d851f1ee63b503d6584113 description: Represents a record shared between Salesforce organizations using Salesforce to Salesforce. --- # PartnerNetworkRecordConnection Represents a record shared between Salesforce organizations using Salesforce to Salesforce. ## Supported Calls create(), query() ## Special Access Rules As of Winter ’21 and later, only authenticated internal and external users can access this object. ## Fields | Field | Details | | --- | --- | | ConnectionId | Type reference Properties Create, Filter, Group, Nillable, Sort Description Required. ID of the connection a record is shared with. | | EndDate | Type dateTime Properties Filter, Nillable, Sort Description Date that sharing of the record was stopped. | | LocalRecordId | Type reference Properties Create, Filter, Group, Sort Description Required. ID of the shared record. | | ParentRecordId | Type reference Properties Create, Filter, Group, Nillable, Sort Description ID of the parent record of the shared record. | | PartnerRecordId | Type reference Properties Filter, Group, Nillable, Sort Description ID of the shared record in the connection's organization. | | RelatedRecords | Type string Properties Create, Filter, Nillable, Sort Description A comma-separated list of API names for child records to be shared with a parent record. | | SendClosedTasks | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort Description Forwards closed tasks related to the shared record. | | SendEmails | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort Description Sends an email notifying the connection's representative that you have forwarded the record to them. Only new recipients of a record will receive a notification email. | | SendOpenTasks | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort Description Forwards open tasks related to the shared record. | | StartDate | Type dateTime Properties Filter, Nillable, Sort Description Date that the shared record was accepted. | | Status | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The status of the shared record. One of the following values: - Active (received) - Active (sent) - Connected - Inactive - Inactive (converted) - Inactive (deleted) - Pending (sent) | ## Usage When you create a PartnerNetworkRecordConnection, you forward a record to a connection. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note Attempting to forward a record from an object to which the connection is not subscribed results in an Invalid Partner Network Status error. When you delete a PartnerNetworkRecordConnection, you stop sharing a record with a connection. - To share a record, use the following fields: LocalRecordID and ConnectionId - To share a child of a parent record, use the following fields: LocalRecordID, ConnectionId, and ParentRecordID - To share a child of a parent record and its child records, use the following fields: LocalRecordID, ConnectionId, ParentRecordID, and RelatedRecords If the organization does not have Salesforce to Salesforce enabled, the PartnerNetworkRecordConnection object is not available, and you can’t access it using the API. #### See Also - [PartnerNetworkConnection](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_partnernetworkconnection.htm "Represents a Salesforce to Salesforce connection between Salesforce organizations.")