---
title: Run a notiflow
full: true
_openapi:
  method: POST
  toc: []
  structuredData:
    headings: []
    contents:
      - content: >
          Execute a notiflow to send notifications to one or more recipients.


          You must provide either `recipients` (direct targeting) or `topic`
          (pub/sub targeting), but not both.


          **Direct targeting (`recipients`):**

          Specify exactly which users should receive the notification. Users are
          identified by their `external_id`.

          If a user doesn't exist, they will be created automatically with the
          provided attributes.


          **Topic targeting (`topic`):**

          Send to all users subscribed to the specified topic. Useful for
          broadcast scenarios.


          **Template variables:**

          The `data` object is passed to notification templates. Access
          variables using Liquid syntax: `{{ data.variable_name }}`
---

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Execute a notiflow to send notifications to one or more recipients.

You must provide either `recipients` (direct targeting) or `topic` (pub/sub targeting), but not both.

**Direct targeting (`recipients`):**
Specify exactly which users should receive the notification. Users are identified by their `external_id`.
If a user doesn't exist, they will be created automatically with the provided attributes.

**Topic targeting (`topic`):**
Send to all users subscribed to the specified topic. Useful for broadcast scenarios.

**Template variables:**
The `data` object is passed to notification templates. Access variables using Liquid syntax: `{{ data.variable_name }}`


<APIPage document={"./openapi-admin.json"} operations={[{"path":"/notiflows/{notiflow_handle}/run","method":"post"}]} />