---
updatedAt: 2026-04-21T16:11:36.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# Ats > JobPosting > Updates

Subscription_type: `ats/job_posting/update`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > Ats > JobPosting > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `ats/job_posting/update`",
        "deprecated": false,
        "summary": "Ats > JobPosting > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ats_job_posting"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      }
    },
    "schemas": {
      "ats_job_posting": {
        "type": "object",
        "required": [
          "id",
          "company_id",
          "ats_company_id",
          "title",
          "remote",
          "status",
          "cv_requirement",
          "cover_letter_requirement",
          "phone_requirement",
          "photo_requirement",
          "personal_url_requirement",
          "salary_period",
          "created_at"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the job posting",
            "example": "1"
          },
          "company_id": {
            "type": "string",
            "description": "Identifier of the company associated with the job posting",
            "example": "1"
          },
          "ats_company_id": {
            "type": "string",
            "description": "Identifier of the ATS company associated with the job posting",
            "example": "1"
          },
          "title": {
            "type": "string",
            "description": "Title of the job posting",
            "example": "My job title"
          },
          "description": {
            "type": "string",
            "description": "Description of the job posting",
            "example": "My job description"
          },
          "contract_type": {
            "type": "string",
            "enum": [
              "indefinite",
              "temporary",
              "intern",
              "training",
              "freelance",
              "vendor_contractor",
              "volunteer",
              "per_hour",
              "other",
              "alternant",
              "interim",
              "minijob",
              "werkstudent",
              "apprenticeship",
              "pj",
              "clt",
              "jovem_aprendiz",
              "a_termo_incerto",
              "a_termo_certo",
              "de_curta_duracao",
              "de_muita_curta_duracao",
              "promessa_de_trabalho",
              "a_tempo_parcial",
              "com_pluralidade_de_empregadores",
              "teletrabalho",
              "pre_reforma",
              "recibos_verdes",
              "estagio",
              "sem_termo",
              "apprentissage",
              "fixed_discontinued",
              "apprendistato"
            ],
            "example": "indefinite"
          },
          "category": {
            "type": "string",
            "enum": [
              "administration_and_secretariat",
              "design_and_architecture",
              "education_and_social_policy",
              "engineering",
              "finance",
              "hr",
              "it",
              "legal",
              "management_and_consulting",
              "marketing_and_communication",
              "nursing_and_therapy",
              "physicians",
              "public_sector",
              "purchasing_materials_administration_and_logistics",
              "sales",
              "sciences_and_research",
              "service_industry_and_manufacturing",
              "sports_art_and_creative_jobs",
              "other"
            ],
            "example": "engineering"
          },
          "workplace_type": {
            "type": "string",
            "enum": [
              "onsite",
              "remote",
              "hybrid"
            ],
            "example": "onsite"
          },
          "remote": {
            "type": "boolean",
            "description": "Indicates if the job posting is remote",
            "example": true
          },
          "status": {
            "type": "string",
            "description": "The current status of the job posting (e.g., draft, published, archived)",
            "enum": [
              "draft",
              "published",
              "unlisted",
              "archived",
              "cancelled",
              "deleted"
            ],
            "example": "draft"
          },
          "schedule_type": {
            "type": "string",
            "description": "The schedule type of the job posting (e.g., full_time, part_time)",
            "enum": [
              "full_time",
              "part_time"
            ],
            "example": "full_time"
          },
          "team_id": {
            "type": "string",
            "description": "Identifier of the team associated with the job posting",
            "example": "1"
          },
          "location_id": {
            "type": "string",
            "description": "Identifier of the location associated with the job posting",
            "example": "1"
          },
          "legal_entity_id": {
            "type": "string",
            "description": "Identifier of the legal entity associated with the job posting",
            "example": "1"
          },
          "salary_format": {
            "type": "string",
            "description": "The format of the salary (e.g., range, fixed_amount)",
            "enum": [
              "fixed_amount",
              "range"
            ],
            "example": "range"
          },
          "salary_from_amount_in_cents": {
            "type": "integer",
            "description": "The minimum salary amount in cents",
            "example": 3000000
          },
          "salary_to_amount_in_cents": {
            "type": "integer",
            "description": "The maximum salary amount in cents",
            "example": 5000000
          },
          "hide_salary": {
            "type": "boolean",
            "description": "Indicates whether the salary information for the job posting should be hidden from applicants.",
            "example": false
          },
          "cv_requirement": {
            "type": "string",
            "description": "Requirement for the CV (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "mandatory"
          },
          "cover_letter_requirement": {
            "type": "string",
            "description": "Requirement for the cover letter (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "optional"
          },
          "phone_requirement": {
            "type": "string",
            "description": "Requirement for the phone number (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "photo_requirement": {
            "type": "string",
            "description": "Requirement for the phone number (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "personal_url_requirement": {
            "type": "string",
            "description": "Requirement for the personal URL (e.g, mandatory, optional, do_not_ask)",
            "enum": [
              "mandatory",
              "optional",
              "do_not_ask"
            ],
            "example": "do_not_ask"
          },
          "url": {
            "type": "string",
            "description": "If published, the public URL of the job posting. Otherwise will be null",
            "example": "https://my-factorial-domain/job_posting/job-title-slug"
          },
          "salary_period": {
            "type": "string",
            "description": "The period of the salary (e.g., annual, monthly, daily)",
            "enum": [
              "annual",
              "monthly",
              "daily"
            ],
            "example": "annual"
          },
          "published_at": {
            "type": "string",
            "description": "Published date in ISO 8601 format of the job. If never been published the value will be null",
            "example": "2024-07-02T08:28:00.000Z"
          },
          "created_at": {
            "type": "string",
            "description": "Date in ISO 8601 format when the job posting was created",
            "example": "2024-07-10T13:30:02.000Z"
          }
        }
      }
    }
  }
}
```