> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotfix.jobs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Product noun is jobs.
> MCP at https://rest.hotfix.jobs/mcp is the hiring contract for agents with a company API key.
> Do not invent unpublished REST, hiring stats, or webhooks.
> Do not mention Greenhouse, Ashby, Quick Apply, or claim.
> Creating a draft, offer, or booking link does not send email.

# create_automation

> Create a Fixed hiring automation (WHEN, IF, THEN). Defaults to paused. branches must include default with the action list. Actions never send email, create offers, or book meetings. A person still hits Send for drafts. MCP tool: create_automation.



## OpenAPI

````yaml /openapi.json post /v1/employer/automations
openapi: 3.1.0
info:
  title: Hotfix hiring API
  version: 1.0.0
  description: >-
    Employer hiring surface under /v1/employer. Most routes take an employer
    session Bearer token. GET resume also accepts a company API key (hf_…).
    Agents should prefer MCP at https://rest.hotfix.jobs/mcp with the same key.
    This is not the public catalog spec at hotfix.jobs/openapi.json, and it is
    not a dump of rest.hotfix.jobs/openapi.json.
servers:
  - url: https://rest.hotfix.jobs
    description: Production
security: []
tags:
  - name: Applications
  - name: Jobs
  - name: Interviews
  - name: Offers
  - name: Mail
  - name: Automations
paths:
  /v1/employer/automations:
    post:
      tags:
        - Automations
      summary: create_automation
      description: >-
        Create a Fixed hiring automation (WHEN, IF, THEN). Defaults to paused.
        branches must include default with the action list. Actions never send
        email, create offers, or book meetings. A person still hits Send for
        drafts. MCP tool: create_automation.
      operationId: create_automation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Display name. At most 120 characters.
                trigger:
                  type: object
                  description: >-
                    WHEN. Object with type. Event types include
                    application.confirmed, status.changed, interview.booked,
                    offer.accepted, and others. type schedule needs cron and
                    optional timezone.
                  additionalProperties: true
                condition_group:
                  type: object
                  description: IF. Optional rule group. Default is and with no conditions.
                  additionalProperties: true
                branches:
                  type: object
                  description: >-
                    THEN. Object with key default whose value is the action
                    list. Actions include set_status, set_assignee,
                    clear_assignee, add_note, archive, restore, and
                    create_draft.
                  properties:
                    default:
                      type: array
                      items:
                        type: object
                        additionalProperties: true
                  required:
                    - default
                job_id:
                  type: string
                  description: Optional job UUID. Null means company-wide.
                status:
                  type: string
                  description: active, paused, or archived. Default paused.
                  default: paused
              required:
                - name
                - trigger
                - branches
            example:
              name: Note on apply
              trigger:
                type: application.confirmed
              branches:
                default:
                  - action: add_note
                    body: New apply in the inbox.
              status: paused
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Employer session JWT from Better Auth.

````