Webhooks

Callback API for our integration partners who want to receive and act upon different Jobylon events.

Model

In Jobylon every webhook has a client url and an event type that it is subscribed to.

Workflow

After the third-party party app registers with Jobylon; they can request webhook intergration by providing a url and the type of events it should subscribe to. The webhook will use these details to send notifications when an event occurs.

When the event is sent to the url the webhook expects a successful response (HTTP 2XX). In the case it does not receive a valid response, it will retry again immediately and then after 30 seconds, 300 seconds (5 minutes), 3000 seconds (50 minutes), 30000 seconds (~8.3 hours) and 300000 seconds (~3 days and 12 hours).

flowchart LR
    subgraph Jobylon ATS
        A["Data Change<br/>(Job/Application/Event/etc     )"] --> A1
        A1["Is request authorized?"] --> B{"Matches additional filters to limit<br/>what data is exposed?"}
        A1 -->|"No"| X["Skip"]
    end
    subgraph Security["Security Layer"]
        B -->|"Yes"| C["Build Request"]
        C --> D["HTTPS POST<br/>+ Basic Auth (optional)<br/>+ Custom Headers (optional)<br/>+ Static IP (optional)"]
    end
    subgraph Delivery["Delivery"]
        D --> E{"2xx?"}
        E -->|"Yes"| F["✓ Delivered"]
        E -->|"No"| G["Retry with Backoff<br/>(6 retries over ~3.5 days)"]
        G --> D
    end
    subgraph Partner["Partner"]
        F --> H["Webhook Endpoint"]
    end
    B -->|"No"| X["Skip"]
    style A fill:#e8f4fc,stroke:#90caf9
    style B fill:#fff8e1,stroke:#ffe082
    style C fill:#f3e5f5,stroke:#ce93d8
    style D fill:#f3e5f5,stroke:#ce93d8
    style E fill:#e8f5e9,stroke:#a5d6a7
    style F fill:#e8f5e9,stroke:#a5d6a7
    style G fill:#fff3e0,stroke:#ffcc80
    style H fill:#e0f7fa,stroke:#80deea
    style X fill:#fce4ec,stroke:#f48fb1

Headers

You can request us to provide you with custom headers if you so choose.

Authentication

You can request us to provide basic authentication by providing a username and password of your choosing.

Limit IP

You can limit the IPs that the callback comes from by letting us know.

Filtering

You can control which webhooks you receive by applying filters that include or exclude events based on specific criteria. For example, you might choose to receive webhooks only for Jobs in a particular Department, or exclude webhooks for Applications belonging to a certain Job. The fields shown in the examples below can be used as filter parameters.

Event Types

Application

AnswersAnswers

Calendar Events

Referral ScoresReferral Scores

Rejection Reason