---
title: "Create a new event for emailing a signee a request for signature"
method: POST
path: "/data_requests/{data_request_id}/events"
tags: ["Data Requests"]
---

# Create a new event for emailing a signee a request for signature

`POST /data_requests/{data_request_id}/events`

Records user notification events for data requests. Use this to create an audit trail
showing when and how users were notified about data request forms. Supports email, SMS,
and other notification types. Records the notification time for compliance tracking.

See also:
- [Embedded Data Requests Guide](https://docspring.com/docs/guides/embedded-forms/embedded-data-requests/) - User notification workflow

## Path parameters

- `data_request_id` string, required

## Request body

- object
  - `event_type` 'send_request' | 'view_request' | 'accepted_terms' | 'decline_request' | 'sign_request' | 'all_completed', required
  - `message_recipient` string, nullable
  - `message_type` 'email' | 'sms' | 'fax' | 'mail' | 'slack' | 'msteams' | 'discord' | 'telegram' | 'whatsapp', nullable
  - `occurred_at` string, nullable

## Response `201`

event created

- object
  - `status` 'success' | 'error', required
  - `event` SubmissionDataRequestEvent, required
    - `id` string, nullable, required
    - `submission_id` string, nullable, required
    - `submission_data_request_id` string, nullable, required
    - `event_type` 'send_request' | 'view_request' | 'accepted_terms' | 'decline_request' | 'sign_request' | 'all_completed', required
    - `message_type` 'email' | 'sms' | 'fax' | 'mail' | 'slack' | 'msteams' | 'discord' | 'telegram' | 'whatsapp', nullable, required
    - `message_recipient` string, nullable, required
    - `occurred_at` string, nullable, required
  - `errors` string[]

## Other responses

- `401` — authentication failed
- `422` — message recipient must not be blank

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)