---
title: "Email Get Or Create"
method: PUT
path: "/api/v1/emails"
tags: ["Emails"]
---

# Email Get Or Create

`PUT /api/v1/emails`

Get or create an email to a Todoist object,
currently only projects and tasks are supported.

## Request body

- Body0dc72dfd
  - `obj_type` 'project' | 'project_comments' | 'task', required
  - `obj_id` string, required — String ID of the Todoist object.

## Response `200`

Successful Response

- EmailResponse
  - `email` string, required — Email address for the Todoist object.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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