Get started

OpenAI fine-tuning job finished notifications on your phone.

Get a push notification when an OpenAI fine-tuning job succeeds, fails or is cancelled, louder when it fails.

Install in Studio See the setup
fine_tuning.job.succeededAI & LLMsCron & background jobs
How it works

Three steps to your first push

STEP 01

Install the recipe

One click in Studio gives you a personal webhook URL.

STEP 02

Paste your URL into OpenAI

Add it as a webhook for fine_tuning.job.succeeded, fine_tuning.job.failed and fine_tuning.job.cancelled.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the OpenAI fine_tuning.job.succeeded, fine_tuning.job.failed and fine_tuning.job.cancelled webhook

  1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
  2. In the OpenAI platform, open Settings > Project > Webhooks (platform.openai.com/settings/project/webhooks) and click Create.
  3. Give the endpoint a name and paste your webhook URL as the URL.https://••••••••/•••••••• your personal URL, shown after install
  4. Tick the fine_tuning.job.succeeded, fine_tuning.job.failed and fine_tuning.job.cancelled event types and save. Webhooks are per project, so repeat this for each project you want pushes from.
  5. Tick **fine_tuning.job.succeeded**, **fine_tuning.job.failed** and **fine_tuning.job.cancelled** (or only the ones you want).
  6. OpenAI's webhook only carries the job ID, so the push says which job finished and links to it in the dashboard. Get the model name with `GET /v1/fine_tuning/jobs/{id}` (`fine_tuned_model`).
  7. Only want to hear about failures? Add `?failures=1` to the URL:
  8. ```
  9. your webhook URL?failures=1
  10. ```
  11. The **Send test event** option on the webhook page sends a sample event with a made-up ID (such as `ftjob_abc123`), so the button on that push won't find a job.
  12. OpenAI signs every delivery (Standard Webhooks: `webhook-id`, `webhook-timestamp`, `webhook-signature`), but JustPush doesn't check that signature yet, so keep your endpoint URL private.
The code

What runs when the webhook arrives

Studio calls handleRequest(request) with the incoming webhook and sends the message it returns. It's yours after install; change anything.

transform.js
1// OpenAI → fine_tuning.job.succeeded / fine_tuning.job.failed / fine_tuning.job.cancelled
2// Fires when a fine-tuning job finishes, fails or is cancelled.
3// Docs: https://developers.openai.com/api/reference/resources/webhooks
4//
5// OpenAI only sends the job ID (data.id). The push links to the job in the dashboard.
6
7// Each event, how to word it, and how loud to be.
8const EVENTS = {
9 "fine_tuning.job.succeeded": {
10 title: "✅ Fine-tuning finished",
11 text: "succeeded. Your fine-tuned model is ready to use",
12 priority: -1, // Low: good news you were waiting for
13 failure: false,
14 },
15 "fine_tuning.job.failed": {
16 title: "❌ Fine-tuning failed",
17 text: "failed. Check the job's error and events",
18 priority: 1, // High: the training run you paid for didn't produce a model
19 failure: true,
20 },
21 "fine_tuning.job.cancelled": {
22 title: "🚫 Fine-tuning cancelled",
23 text: "was cancelled",
24 priority: -1, // Low: someone cancelled it on purpose
25 failure: false,
26 },
27}
28
29// Table lookup that ignores inherited names such as "toString".
30function pick(table, key, fallback) {
31 return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
32}
33
34// Only link to real http(s) URLs.
35function link(url, cta) {
36 return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
37}
38
39// OpenAI IDs look like "ftjob-abc123"; anything else isn't used in text or links.
40function cleanId(value) {
41 return typeof value === "string" && /^[A-Za-z0-9_-]{1,128}$/.test(value) ? value : null
42}
43
44function handleRequest(request) {
45 const body = request.body && typeof request.body === "object" ? request.body : {}
46 const event = pick(EVENTS, body.type, null)
47
48 // Guard: only fine-tuning job events, so other OpenAI events on this integration stay quiet.
49 if (!event) {
50 console.log(`Ignoring OpenAI "${typeof body.type === "string" ? body.type : "unknown"}" event`)
51 return null
52 }
53
54 // ?failures=1 on the webhook URL only pushes failed jobs.
55 const failuresOnly = ["1", "true", "yes"].includes(String(request.query?.failures ?? "").toLowerCase())
56 if (failuresOnly && !event.failure) {
57 console.log(`Skipping ${body.type} (failures only)`)
58 return null
59 }
60
61 const id = cleanId(body.data?.id)
62
63 return {
64 title: event.title,
65 message: `${id ? `Job ${id}` : "A fine-tuning job"} ${event.text}.`,
66 topic: "OpenAI",
67 priority: event.priority,
68 buttons: link(id ? `https://platform.openai.com/finetune/${id}` : "https://platform.openai.com/finetune", "View job"),
69 }
70}
Payload

The OpenAI fine_tuning.job.succeeded webhook

This is what OpenAI sends to your URL for fine_tuning.job.succeeded, fine_tuning.job.failed and fine_tuning.job.cancelled. It is a sample, trimmed to the fields recipes use.

fine_tuning.job.succeeded · sample.json
1{
2 "id": "evt_685343a1381c819085d44c354e1b3310",
3 "data": {
4 "id": "ftjob_abc123"
5 },
6 "type": "fine_tuning.job.succeeded",
7 "object": "event",
8 "created_at": 1790668800
9}
FAQ

OpenAI fine-tuning job finished notifications: questions

Does this work on iPhone and Android?

Yes. Install the JustPush app from the App Store or Google Play and sign in. Every phone signed in to your account gets the notification.

Do I need to write code?

No. Install the recipe in Studio, paste your webhook URL into OpenAI and you are done. The code is there if you want to change the text, the sound or the buttons.

Can I change what the notification says?

Yes. After install the recipe's code is yours. Edit it in Studio and test it against the sample payload before you save.

What does it cost?

JustPush is free for 30 days. After that it's $19.99 a year, or $39.99 once. There is no extra charge for recipes.

More recipes

More from OpenAI

OpenAI

Background response finished

Get a push notification when an OpenAI background response completes, fails, stops early or is cancelled, louder when it fails.

response.completedButtons
OpenAI

Batch finished

Get a push notification when an OpenAI Batch API job completes, fails, expires or is cancelled.

batch.completedButtons
OpenAI

Eval run finished

Get a push notification when an OpenAI eval run finishes, fails or is canceled.

eval.run.succeededButtons

All 5 OpenAI recipes

Cron & background jobs

More cron & background jobs recipes

Cronitor

Monitor failed or recovered

Get a push notification when a Cronitor cron job, heartbeat or website check fails, and a quiet one when it recovers.

alert
Healthchecks.io

Check down or up

Get a push notification when a Healthchecks.io cron job or heartbeat misses its ping or reports a failure, and a quiet one when it recovers.

statusButtons
LangSmith

Agent run finished

Get a push notification when a LangGraph agent run finishes, fails or times out, with how long it took and the agent's final answer.

run

All cron & background jobs recipes

Ready when you are

OpenAI on your phone in two minutes.

Install the recipe, paste one URL, done. Free for 30 days, no credit card required.

Install in Studio Download for iOS Download for Android