> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.todoist.core.CreateReminder

- Component: `appmixer.todoist.core.CreateReminder`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.todoist 1.1.3](https://connectors.appmixer.com/connector/appmixer.todoist/1.1.3.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.todoist/1.1.3/component/appmixer.todoist.core.CreateReminder>

Create a new reminder for a task.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Task ID (`taskId`) | text | The ID of the task to add a reminder for. For relative reminders, the task must have a due date set. |
| Type (`type`) | select | The type of the reminder. |
| Due String (`dueString`) | text | Human-readable due date for absolute reminders, e.g., 'tomorrow at 10am'. |
| Due Datetime (`dueDatetime`) | date-time | Specific date and time for absolute reminders. |
| Minute Offset (`minuteOffset`) | number | Number of minutes before the task's due time for relative reminders. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| ID (`id`) | string | - |
| Task ID (`item_id`) | string | - |
| Type (`type`) | string | - |
| Due (`due`) | object | - |
| Minute Offset (`minute_offset`) | integer | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.todoist.core.CreateReminder",
  "author": "Appmixer <info@appmixer.com>",
  "description": "Create a new reminder for a task.",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:todoist"
  },
  "quota": {
    "manager": "appmixer:todoist",
    "resources": "requests",
    "scope": {
      "userId": "{{userId}}"
    }
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "taskId": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "dueString": {
            "type": "string"
          },
          "dueDatetime": {
            "type": "string",
            "format": "date-time"
          },
          "minuteOffset": {
            "type": "number"
          }
        },
        "required": [
          "taskId",
          "type"
        ]
      },
      "inspector": {
        "inputs": {
          "taskId": {
            "type": "text",
            "label": "Task ID",
            "tooltip": "The ID of the task to add a reminder for. For relative reminders, the task must have a due date set.",
            "index": 1
          },
          "type": {
            "type": "select",
            "label": "Type",
            "tooltip": "The type of the reminder.",
            "index": 2,
            "options": [
              {
                "label": "Relative",
                "value": "relative"
              },
              {
                "label": "Absolute",
                "value": "absolute"
              }
            ]
          },
          "dueString": {
            "type": "text",
            "label": "Due String",
            "tooltip": "Human-readable due date for absolute reminders, e.g., 'tomorrow at 10am'.",
            "index": 3
          },
          "dueDatetime": {
            "type": "date-time",
            "label": "Due Datetime",
            "tooltip": "Specific date and time for absolute reminders.",
            "index": 4
          },
          "minuteOffset": {
            "type": "number",
            "label": "Minute Offset",
            "tooltip": "Number of minutes before the task's due time for relative reminders.",
            "index": 5
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "title": "ID"
          },
          "item_id": {
            "type": "string",
            "title": "Task ID"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "due": {
            "type": "object",
            "title": "Due",
            "properties": {
              "string": {
                "type": "string",
                "title": "Due String"
              },
              "date": {
                "type": "string",
                "title": "Due Date"
              },
              "datetime": {
                "type": "string",
                "title": "Due Datetime"
              },
              "timezone": {
                "type": "string",
                "title": "Due Timezone"
              }
            }
          },
          "minute_offset": {
            "type": "integer",
            "title": "Minute Offset"
          }
        },
        "example": {
          "id": "2719296753",
          "item_id": "9907445074",
          "type": "relative",
          "due": {
            "string": "2026-01-15 09:30",
            "date": "2026-01-15T09:30:00",
            "datetime": "2026-01-15T10:00:00Z",
            "timezone": "America/New_York"
          },
          "minute_offset": 30
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
