Salesforce
Learn how to use Salesforce with Composio
Overview
Enum
SALESFORCE
Description
Salesforce is a leading CRM platform integrating sales, service, marketing, and analytics to build customer relationships and drive business growth
Authentication Details
OAUTH2
Actions
SALESFORCE_CREATE_LEAD_WITH_SPECIFIED_CONTENT_TYPE
Create a new lead via post, specifying content type in the header. accepts a json lead object. possible response status codes include 201 (created), 400, 401, 403, 404, 405, 415, 500, 503, along with corresponding error info.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_ACCOUNT_DATA_AND_ERROR_RESPONSES
Retrieve account data with response codes for success and various errors (not modified, bad request, unauthorized, forbidden, not found, method not allowed, server error, service unavailable). returns sobjectrootinfo on success.
Action Parameters
Action Response
SALESFORCE_CREATE_NEW_CONTACT_WITH_JSON_HEADER
The post /sobjects/contact endpoint creates a new contact using json; it requires a content-type header. success and error responses range from status codes 201 to 503.
Action Parameters
Action Response
SALESFORCE_UPDATE_OPPORTUNITY_BY_ID
This patch endpoint allows updates to an existing opportunity object by id, accepts json payloads, and supports multiple response statuses, including 400, 401, 403, 404, 500, 405, 503, 204, and 415, indicating various error conditions or success.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_SPECIFIC_CONTACT_BY_ID
This endpoint retrieves a specific contact by id. it supports optional field selection and conditional retrieval based on modification timestamp. responses cover a range of http status codes from success to various client and server errors.
Action Parameters
Action Response
SALESFORCE_UPDATE_CAMPAIGN_BY_ID_WITH_JSON
Update a campaign object by id with json support. requires ‘id’ path parameter and ‘content-type’ header. potential responses: 200 ok, 400, 401, 403, 404, 405, 415, 500, 503 errors, and 204 no content.
Action Parameters
Action Response
SALESFORCE_REMOVE_OPPORTUNITY_BY_ID
Delete an opportunity object using its unique id, handling responses for success and common http errors like bad request, unauthorized access, forbidden, not found, and server errors.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_CONTACT_INFO_WITH_STANDARD_RESPONSES
Get /sobjects/contact: retrieves contact info with standard response codes, including successful fetch (200) and various errors (304, 400, 401, 403, 404, 405, 412, 500, 503). json format expected.
Action Parameters
Action Response
SALESFORCE_UPDATE_ACCOUNT_OBJECT_BY_ID
Patch endpoint ‘/sobjects/account/{id}
’ updates an account object by its id, using ‘application/json’. requires ‘content-type’ header and may return status codes 400, 401, 403, 404, 500, 405, 503, 204, or 415.
Action Parameters
Action Response
SALESFORCE_ACCOUNT_CREATION_WITH_CONTENT_TYPE_OPTION
Endpoint for creating accounts via post; accepts json with ‘content-type’ header. status codes: 201 (created), 400, 401, 403-405, 415, 500, 503.
Action Parameters
Action Response
SALESFORCE_DELETE_A_LEAD_OBJECT_BY_ITS_ID
Delete a lead object by id. errors handled for missing auth, access rights, nonexistent object, and server issues. returns no content on success (204). required: id
path parameter.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_LEAD_DETAILS_BY_ID_WITH_CONDITIONAL_SUPPORT
Retrieve details of a lead by id, with optional field selection and conditional retrieval based on modification dates. supports responses for success, various client or server errors, and change detection statuses.
Action Parameters
Action Response
SALESFORCE_UPDATE_SPECIFIC_NOTE_BY_ID
Patch /sobjects/note/{id}
: update a specific note object using its id. requires ‘content-type’ header and json body with the note’s new content. responses: 204 on success, 400-415, 500, or 503 for errors.
Action Parameters
Action Response
SALESFORCE_CREATE_CAMPAIGN_RECORD_VIA_POST
Create a new campaign record by posting json data to ‘/sobjects/campaign’. must include ‘content-type’ header. possible responses include success (201) and various errors like 400, 401, 403, 404, 405, 415, 500, 503 with descriptive info.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_SPECIFIC_CAMPAIGN_OBJECT_DETAILS
Retrieve details of a specific campaign object using its id. optional query/header params allow for field selection and date-based filtering. expect standard http response codes, such as 200 ok or 404 not found, for outcomes.
Action Parameters
Action Response
SALESFORCE_REMOVE_NOTE_OBJECT_BY_ID
Delete a note object by id. supports error handling for common http response statuses including 400, 401, 403, 404, 500, 405, 503, and 415; 204 for success. required parameter: ‘id’ in path.
Action Parameters
Action Response
SALESFORCE_UPDATE_LEAD_BY_ID_WITH_JSON_PAYLOAD
Patch endpoint updates lead by id with json body per leadsobject schema, needs content-type header; responses vary from 204 to error codes 400, 401, 403, 404, 415, 500, 503 with error info.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_LEAD_DATA_WITH_VARIOUS_RESPONSES
Retrieve lead data with potential responses: 200 (success), 304 (not modified), 400 (bad request), 401 (unauthorized), 403 (forbidden), 404 (not found), 405 (method not allowed), 412 (precondition failed), 500 (server error), 503 (service unavailable).
Action Parameters
Action Response
SALESFORCE_CREATE_OPPORTUNITY_RECORD
Create ‘opportunity’ records with required ‘content type’ header (json/xml). successfully created records return a 201 status code. errors trigger status codes 400, 401, 403, 404, 405, 415, 500, or 503 with details. ensure fields used are available based on the organization’s salesforce configuration.
Action Parameters
Action Response
SALESFORCE_REMOVE_CAMPAIGN_OBJECT_BY_ID
Delete /sobjects/campaign/
{id}“: removes a campaign object given an id
. responds with 204 on success or returns error codes 400, 401, 403, 404, 405, 415, 500, 503 with details if any issues arise. the id
path parameter is required.
Action Parameters
Action Response
SALESFORCE_QUERY_REPORT
Post returns report data without saving changes to an existing report or creating a new one.
Action Parameters
Action Response
SALESFORCE_CREATE_NOTE_RECORD_WITH_CONTENT_TYPE_HEADER
Create a note record by posting json data to /sobjects/note
. requires content-type
header and handles various http statuses (201, 400, 401, 403, 404, 500, 405, 503, 415) signaling success or different error scenarios.
Action Parameters
Action Response
SALESFORCE_FETCH_MODIFIED_OR_UNMODIFIED_SOBJECTS
Retrieve a list of modified sobjects by using “if-modified-since” header or unmodified with “if-unmodified-since”. supports common response codes like 200, 304, and error codes 400, 401, 403, 404, 405, 412, 500, 503.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_CAMPAIGN_DATA_WITH_ERROR_HANDLING
Get /sobjects/campaign: retrieves campaign data with responses for success and various errors like missing authorization, not found, and server issues.
Action Parameters
Action Response
SALESFORCE_UPDATE_CONTACT_BY_ID
Patch /sobjects/contact/{id}
: update specified contact using its id. requires ‘content-type’ header and json request body. possible responses: 204 (success), 400, 401, 403, 404, 405, 415, 500, 503 (errors).
Action Parameters
Action Response
SALESFORCE_REMOVE_A_SPECIFIC_CONTACT_BY_ID
Delete a contact object by id. handles errors: bad request (400), unauthorized (401), forbidden (403), not found (404), internal server error (500), method not allowed (405), service unavailable (503), and unsupported media type (415).
Action Parameters
Action Response
SALESFORCE_FETCH_ACCOUNT_DETAILS_BY_ID_WITH_CONDITIONAL_QUERIES
Retrieve account details by id, with optional fields and conditional headers. responds with account data or error statuses. supports if-modified/unmodified for data freshness.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_OPPORTUNITY_BY_ID_WITH_OPTIONAL_FIELDS
Retrieve opportunity details by id using get. optional fields and modified-since query supported. responses range from 200 (ok) to 503 (service unavailable), including various client/server errors.
Action Parameters
Action Response
SALESFORCE_REMOVE_ACCOUNT_BY_UNIQUE_IDENTIFIER
Delete /sobjects/account/{id}
: removes an account using a unique identifier. requires the ‘id’ path parameter. possible responses include 400, 401, 403, 404, 500, 405, 503 (errors) and 204 (success).
Action Parameters
Action Response
SALESFORCE_RETRIEVE_NOTE_OBJECT_INFORMATION
Access notes with /sobjects/note
. possible responses range from 200 (ok) to 503 (service unavailable) and return json data.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_NOTE_BY_ID_WITH_OPTIONAL_FIELDS_AND_TIME_CONDITIONS
Retrieve a specific note object by id with optional field selection and conditional retrieval based on modification time. supports standard http response codes to indicate success or issues with the request.
Action Parameters
Action Response
SALESFORCE_RETRIEVE_OPPORTUNITIES_DATA
Retrieve opportunities data. supports http 200 for success; errors return 304, 400, 401, 403, 404, 405, 412, 500, or 503 statuses with respective descriptions. response in json.
Action Parameters
Action Response