JOjobadder
Company API:Companies

Add a new company

Changed on
post/companies

Request

  • Base URL
    https://api.jobadder.com/v2
  • URL
    https://api.jobadder.com/v2/companies
  • Auth
    OAuth 2
    Authorization code: https://id.jobadder.com/connect/authorize
    Token URL: https://id.jobadder.com/connect/token scopes: write, write_company

Headers

X-Allow-Duplicatesstring

Duplicate override code from the header of an earlier 409 response

Request body

namestring required
parentCompanyIdinteger nullable
summarystring nullable
legalNamestring nullable

Company LegalName

socialobject nullable
statusIdinteger nullable

Company status

ownerUserIdinteger nullable
recruiterUserIdinteger[] nullable

Example request

{
  "social": {
    "facebook": "https://www.facebook.com/JobAdder",
    "twitter": "https://twitter.com/jobadder",
    "linkedin": "https://www.linkedin.com/company/866656/"
  },
  "custom": [
    {
      "fieldId": 1,
      "value": "Text value"
    },
    {
      "fieldId": 2,
      "value": [
        "List value 1",
        "List value 2"
      ]
    },
    {
      "fieldId": 3,
      "value": "2018-07-01"
    }
  ]
}

Response

Created

companyIdinteger required

Unique identifier for the company

namestring nullable

Company name

legalNamestring nullable
socialobject nullable

Company social profiles

summarystring nullable
createdAtstring date-time nullable
updatedAtstring date-time nullable

Example response

{
  "social": {
    "facebook": "https://www.facebook.com/JobAdder",
    "twitter": "https://twitter.com/jobadder",
    "linkedin": "https://www.linkedin.com/company/866656/"
  },
  "custom": [
    {
      "fieldId": 1,
      "name": "Text Field 1",
      "type": "Text",
      "value": "Text value"
    },
    {
      "fieldId": 2,
      "name": "List Field 2",
      "type": "List",
      "value": [
        "Value 1",
        "Value 2"
      ]
    },
    {
      "fieldId": 3,
      "name": "Date Field 3",
      "type": "Date",
      "value": "2018-07-01"
    }
  ]
}

Changes

  • 9f43f6a6ee6eRevision changes
    • info

      added optional request body

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status