Newer Version Available

This content describes an older version of this product. View Latest

Use CORS to Access Chatter REST API, REST API, and Lightning Out

Chatter REST API, REST API, and Lightning Out support CORS (cross-origin resource sharing). To access these APIs from JavaScript in a Web browser, add the origin serving the script to the CORS whitelist.
Available in: Salesforce Classic and Lightning Experience
Available in: Developer, Enterprise, Performance, and Unlimited

User Permissions Needed
To create, read, update, and delete: “Modify All Data”

CORS is a W3C recommendation that enables Web browsers to request resources from origins other than their own (cross-origin request). For example, using CORS, a JavaScript script at https://www.example.com could request a resource from https://www.salesforce.com.

If a browser that supports CORS makes a request to an origin in the Salesforce CORS whitelist, Salesforce returns the origin in the Access-Control-Allow-Origin HTTP header, along with any additional CORS HTTP headers. If the origin is not included in the whitelist, Salesforce returns HTTP status code 403.

  1. From Setup, enter CORS in the Quick Find box, then select CORS.
  2. Choose New.
  3. Enter an origin URL pattern.
    The origin URL pattern must include the HTTPS protocol and a domain name, and may include a port. The wildcard character (*) is supported and must be in front of a second-level domain name. For example, https://*.example.com adds all subdomains of example.com to the whitelist.
    The origin URL pattern can be an IP address. However, an IP address and a domain that resolve to the same address are not the same origin, and you must add them to the CORS whitelist as separate entries.

You must still pass an OAuth token with requests that require it.

Important