PatchEmployerInput

Input Object

Partial updates:

Action	Regular fields	Array fields
Keep unchanged	Omit the field	Omit the field
Remove value	Set to null	Set to []
Overwrite	Set new value	Set new array

Example:

{
  "id": {
    "type": "INDEED_EMPLOYER_KEY",
    "id": "Employer key"
  },
  "employerName": "Example company",
  "employerAttributes": {
    "countrySpecificAttributes": [{
      "country": "US",
      "sectorSUIDs": ["SUID-of-some-indeed-sector"]
    }],
    "localeSpecificAttributes": [{
      "country": "US",
      "language": "en",
      "isGlobalDefault": true,
      "description": "Description of example company",
      "squareLogo": "Base64-encoded-string"
    }]
  }
}

---

Fields

id EmployerIdentifiersInput! Required

Globally unique IRI for the employer.

type String! Required

Identifier type.

• Indeed internal clients: See valid types in EmployerIdentifierType (opens in a new window).
• Others: Communicated individually.

id ID! Required

ID.

employerName String

Official employer name. Required to create an employer key. Optional for submitting employer data.

Limits: 255 UTF-16 characters. No email addresses or 8+ consecutive digits.

employerName is copied to the global localizedName field unless explicitly set in the request.

employerAttributes EmployerAttributesInput

Employer attributes to update. If null, nothing is updated.

employerType EmployerType

Employer type.

Japan: Specify 企業区分 (法人 or 個人).

countrySpecificAttributes [CountrySpecificEmployerAttributesInput!]

Country-specific employer attributes.

country CountryCode! Required

ISO 3166-1 alpha-2 country code (such as US, JP).

isGlobalDefault Boolean! Deprecated default:true

Deprecated. Always true for CountrySpecificEmployerAttributes. When true, data is also written to ww_WW internally.

websiteUrl String

Employer's root website (such as indeed.com). For franchises, use the brand website.

Limits: 400 characters. Must be a valid URL.

phoneNum String Deprecated

Deprecated. Use phoneNumber instead.

phoneNumber PhoneNumber

Employer's official phone number in E.164 (opens in a new window) format.

Example: +17895551234

taxId String

Employer's tax identifier. Limit: 100 characters.

Japan: If employerType is JURIDICAL_PERSON, set to the corporate number (法人番号) for correct identification. If employerType is NATURAL_PERSON, this field is optional.

sectorSUIDs [ID!]

Sector (industry) SUIDs. Maximum 3, must be valid.

Japan: Company sectors (opens in a new window).

employees String

Employer's workforce size. Allowed values:

Value	Number of employees
ERv1_1	1
ERv1_2_10	From 2 to 10
ERv1_11_50	From 11 to 50
ERv1_1_50	From 1 to 50
ERv1_51_200	From 51 to 200
ERv1_201_500	From 201 to 500
ERv1_501_1000	From 501 to 1000
ERv1_1001_5000	From 1001 to 5000
ERv1_5001_10000	From 5001 to 10000
ERv1_10000_PLUS	10000+ employees

localeSpecificAttributes [LocaleSpecificEmployerAttributesInput!]

Locale-specific employer attributes (lang + country).

country CountryCode! Required

ISO 3166-1 alpha-2 country code (such as US, JP).

ww_WW is not accepted. All data must specify a valid country and language.

language LanguageCode! Required

ISO 639-1 alpha-2 language code (such as en, ja).

ww_WW is not accepted. All data must specify a valid country and language.

isGlobalDefault Boolean! default:true

If true, sets this data as the global default.

localizedName String

Localized employer name. Limit: 1 to 60 characters.

If the request uses the Ignore operation to omit this field but provides employerName, then the global localizedName field is set to the employerName field value.

Examples:

Field	Example value
name	Yamada Kyujin
localizedName	山田求人 (ja_JP)
phoneticName	ヤマダキュウジン (ja_JP)

Field	Example value
name	Google
localizedName	グーグル (ja_JP)
phoneticName	グーグル (ja_JP)

Field	Example value
name	Rakuten
localizedName	楽天 (ja_JP)
phoneticName	ラクテン (ja_JP)

phoneticName String

Employer phonetic name. Limit: 250 characters.

Examples:

Field	Example value
name	Yamada Kyujin
localizedName	山田求人 (ja_JP)
phoneticName	ヤマダキュウジン (ja_JP)

Field	Example value
name	Google
localizedName	グーグル (ja_JP)
phoneticName	グーグル (ja_JP)

Field	Example value
name	Rakuten
localizedName	楽天 (ja_JP)
phoneticName	ラクテン (ja_JP)

description String

Employer description.

squareLogo String

Base64-encoded square logo.

Dimensions:

• Minimum: 256×256 pixels
• Maximum: 4096×4096 pixels

headquarterAddress String

Headquarters address. Japan: 本社所在地住所

leader LeaderInput

Leader information.

jpNewGradsAttributes JpNewGradsEmployerAttributesInput

JP new grads employer attributes.

schoolsWithHiringRecords [String!]

Schools the employer has hired graduates from.

Limits: Max 1000 schools, each name under 100 characters.

Example

{
  "id": EmployerIdentifiersInput,
  "employerName": "abc123",
  "employerAttributes": EmployerAttributesInput
}

 

Was this page helpful?