> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nostrapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Make Post

> Post notes and events to any Nostr relay

### Body

<ParamField body="content" type="string">
  The contents of the post you wish to publish. This can be any string of text, can include any links.
</ParamField>

<ParamField body="relays" type="array">
  The array of relay URLs you wish to publish your post to.
</ParamField>

<ParamField body="when" type="number" optional="true">
  If you want to schedule the post to be published at a later time, you can pass a UNIX timestamp number here. If you do not pass this parameter, the post will be broadcast immediately.
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the call was successful. `true` if successful, `false` if not.
</ResponseField>

<ResponseField name="message" type="string">
  Message detailing the results of the operation.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request POST 'https://nostrapi.com/api/v1/post' \
  --header 'Content-Type: application/json' \
  --header 'apikey: <YOUR_KEY_HERE>' \
  --data-raw '{
      "relays": ["wss://nostr.zbd.gg", "wss://relay.damus.io"],
      "content": "GM NOSTR FAM",
      "when": 1685405495
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json HTTP 200 - Success theme={null}
  {
    "success": true,
    "message": "Successfully published b4edd89a1c06c1aced80ed799090c418685939b3fe8778f8e76cc7ff1f2e36d7 event."
  }
  ```
</ResponseExample>