Webhooks

Receive real-time notifications when data changes in the Journey Foods platform.

Event Types

Event	Description
ingredient.created	A new ingredient was added to the database
ingredient.updated	An ingredient's data was modified
ingredient.deleted	An ingredient was removed from the database
formulation.completed	An AI formulation request has completed

Webhook Payload

{
  "id": "evt_abc123",
  "type": "ingredient.updated",
  "created_at": "2024-06-20T14:45:00Z",
  "data": {
    "ingredient_id": "ing_tomato_001",
    "changes": ["nutrients", "sustainability_score"]
  }
}

{
  "id": "evt_abc123",
  "type": "ingredient.updated",
  "created_at": "2024-06-20T14:45:00Z",
  "data": {
    "ingredient_id": "ing_tomato_001",
    "changes": ["nutrients", "sustainability_score"]
  }
}

Webhook endpoints must respond with a 2xx status code within 30 seconds. Failed deliveries will be retried up to 3 times with exponential backoff.