Upsert

Updates or inserts an object from external data.

Salesforce inserts or updates a record depending on whether the external ID currently exists in the external ID field. To force Salesforce to create a new record, set the name of the external ID field to “Id” and the external ID to null.

Parameters

API version (string, optional)
Object type (string)
External ID field (string)
External ID (string, optional)
Fields (map, optional)—Maps each field name to an object containing its value

If fields is null, the upserted record is empty.

iOS

Swift

1RestClient.shared.requestForUpsert(withObjectType:externalIdField:externalId:fields:)

Objective-C

1- (SFRestRequest *)requestForUpsertWithObjectType:(NSString *)objectType
2                                externalIdField:(NSString *)externalIdField
3                                     externalId:(nullable NSString *)externalId
4                                          fields:(NSDictionary<NSString*, id> *)fields
5                                       apiVersion:(nullable NSString *)apiVersion;

Android

Kotlin

1fun getRequestForUpsert(apiVersion: String?, objectType: String?,
2    externalIdField: String?, externalId: String?,
3    fields: Map<String?, Any?>?): RestRequest

Java

1public static RestRequest getRequestForUpsert(String apiVersion,
2    String objectType, String externalIdField, String externalId,
3    Map<String, Object> fields)

Upsert

Parameters

iOS

Android

See Also