---
title: "Notify a single intent"
description: "Send the back-in-stock notification for a single intent immediately, regardless of current inventory. By default an intent that has already been notified will not be sent again; set allow_resend to true to force a resend"
url: https://docs.stoqapp.com/v1/back-in-stock/notify-a-single-intent/
api: "API v1 (legacy)"
method: POST
path: "/external/intents/notify_intent"
---

# Notify a single intent

`POST https://app.stoqapp.com/api/v1/external/intents/notify_intent`

Send the back-in-stock notification for a single intent immediately, regardless of current inventory. By default an intent that has already been notified will not be sent again; set `allow_resend` to true to force a resend. Returns 404 if the intent does not exist and 422 if the notification could not be sent.

## Request body

- `id` (string): Intent ID
- `allow_resend` (boolean): Allow resending notification

## Returns

- `success` (boolean): e.g. `true`
- `intent_id` (string): e.g. `8f3c2b1a-7d4e-4c2a-9f10-2b3c4d5e6f70`

Rate limit: this call costs 2 points ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl -X POST "https://app.stoqapp.com/api/v1/external/intents/notify_intent" \
  -H "X-Auth-Token: $STOQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "8f3c2b1a-7d4e-4c2a-9f10-2b3c4d5e6f70",
    "allow_resend": false
  }'
```

## 200

Notification sent successfully

```json
{
  "success": true,
  "intent_id": "8f3c2b1a-7d4e-4c2a-9f10-2b3c4d5e6f70"
}
```

## 401

Unauthorized

## 404

Intent not found

## 422

Failed to notify intent