---
title: "Create a scheduled event"
method: POST
path: "/v1/social-accounts/{id}/events"
tags: ["Channels"]
---

# Create a scheduled event

`POST /v1/social-accounts/{id}/events`

## Request

- Base URL: `https://api.postlake.dev`
- URL: `https://api.postlake.dev/v1/social-accounts/{id}/events`
- Auth: `bearerAuth` (a scheme the document does not define)

Create an event on the account, where the network allows it through the API. Instagram calls this a reminder and normally expects it to be added while composing a post in the app; this asks the API directly, and a network that refuses says so in its own words. The returned id goes in the `upcomingEventId` post option.

## Path parameters

- `id` string, required

## Request body

- object
  - `title` string, required
  - `startsAt` string, date-time, required
  - `endsAt` string, date-time

## Response `201`

Created

- object
  - `id` string, required
  - `title` string, required
  - `startsAt` string, nullable
  - `endsAt` string, nullable

---

[API](https://skmtc.dev/postlake/apis/postlake-api.md) · [All operations](https://skmtc.dev/postlake/apis/postlake-api/llms.txt) · [OpenAPI document](https://skmtc.dev/postlake/apis/postlake-api/revisions/f81060e31f69?raw)