Employers

Create and update employer entities on Indeed and the Indeed PLUS platform. Not available for direct employers.

 

Overview

An employer on Indeed is a company or other organization that has jobs associated with it. ATS partners can use the Employer Data API to create and update employers.

Every employer has an ID, a name, and other attributes. Indeed moderates employers so that they include all required information and omit inappropriate content.

Employer entities that you create through the Employer Data API do not need their own Indeed employer accounts. These employer entities have no relationship with Indeed employer accounts.

You must create an employer before you create a job associated with that employer.

Sending requests

To authenticate, use a 2-legged OAuth token. The OAuth app you use must have permission to create employers. When you set up your app, Indeed grants the permission.

For more information about calling Indeed's GraphQL APIs, see GraphQL at Indeed.

Employer data

If you are an ATS partner, inform your employer clients about what data of theirs you send to Indeed, and how Indeed uses that data.

If someone with more authority than you provides Indeed with employer data, Indeed might overwrite your provided employer data.

Scopes of employer attributes

Indeed may display employer data differently based on the country and locale. Attributes that you pass to patchEmployer have different scopes so Indeed can choose the optimal combination of attributes to provide employer information to job seekers.

Employer data have these scopes:

1. Global scope: No matter in which country the employer operates, the value is the same.
   • The global attributes are employerName and employerType.
2. Country scope: The attribute value can differ by location.
   • countrySpecificAttributes contains all country-scope attributes.
   • When you update country-scope attributes, provide an ISO 3166-1 two-letter country code value in the country field in countrySpecificAttributes.
3. Locale scope: You can localize the attribute value by country and language.
   • localeSpecificAttributes contains all locale-scope attributes.
   • When you update locale-scope attributes, provide an ISO 3166-1 two-letter country code in the country field and an ISO 639-1 two-letter language code in the language field in localeSpecificAttributes. For the valid combinations of language and country, see Supported locales.
   • By default, the updated attributes are automatically set to global. localeSpecificAttributes contains the isGlobalDefault option, and its default value is true. The API returns this value for queries that specify a locale that does not have a translation. For example, if you query for a description in fr-CA to an employer without that translation, the API returns the global default.

Troubleshoot errors

To troubleshoot OAuth errors that can occur before you access GraphQL, see Troubleshoot OAuth errors.

To troubleshoot GraphQL errors, see Troubleshoot GraphQL errors.

Start here

Topic	Description
Operations	Create and update employers on Indeed and the Indeed PLUS platform using the Employer Data API. Not available for direct employers. Create an employer: Create an employer on Indeed and Indeed PLUS. Update an employer: Update an employer on Indeed and Indeed PLUS.
For Japan partners	Additional requirements and information for partners creating and updating employers in Japan. Posting guidelines and examples: Guidelines for creating and updating employers in Japan. Field visibility: Employer fields that job seekers can view on at least one Indeed PLUS job board.
Reference	Reference information for partners using the Employer Data API. Supported locales: Locales that the Employer Data API supports. Company sectors: Sectors that the Employer Data API supports.