---
title: "Report an invitation status event"
method: POST
path: "/v1/provider-portal-invitations/events"
tags: ["ProviderPortalInvitations"]
---

# Report an invitation status event

`POST /v1/provider-portal-invitations/events`

Reports a status transition event for a provider portal invitation. Called by the provider portal when a provider opens the email, clicks the signup link, or completes signup.

## Request body

- object
  - `event_type` 'signed_up' | 'opened' | 'clicked', required — The type of status event to report
  - `invitation_id` string, required — The ProviderPortalInvitation document _id
  - `provider_id` string — The provider Chart/Provider _id in BlueHive (required for signed_up events)
  - `metadata` object — Additional metadata about the event

## Response `200`

Default Response

- object
  - `success` boolean
  - `invitation_id` string
  - `previous_status` string
  - `new_status` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `404` — Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)