---
title: "Post a cast"
method: POST
path: "/v2/farcaster/cast/"
tags: ["Cast"]
---

# Post a cast

`POST /v2/farcaster/cast/`

Posts a cast or cast reply. Works with mentions and embeds.  
(In order to post a cast `signer_uuid` must be approved)

## Request body

- PostCastReqBody
  - `channel_id` string — Channel ID of the channel where the cast is to be posted. e.g. neynar, farcaster, warpcast
  - `embeds` PostCastReqBodyEmbeds[]
    - union
      - object
        - `cast_id` PostCastReqBodyEmbedsCastIdProperties, required
          - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
          - `hash` string, required
      - object
        - `castId` PostCastReqBodyEmbedsCastIdProperties, required
          - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
          - `hash` string, required
      - object
        - `url` string, required
  - `idem` string — An Idempotency key is a unique identifier for the request. **Note:** 1) This is used to prevent duplicate requests. Use the same idem key on retry attempts. 2) This should be a unique identifier for each request. 3) Recommended format is a 16-character string generated by the developer at the time of making this request.
  - `parent` string — parent_url of the channel the cast is in, or hash of the cast
  - `parent_author_fid` integer — The unique identifier of a farcaster user or app (unsigned integer)
  - `signer_uuid` string, required — UUID of the signer. `signer_uuid` is paired with API key, can't use a `uuid` made with a different API key.
  - `text` string

## Response `200`

Success

- PostCastResponse
  - `cast` object, required
    - `author` object, required
      - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
    - `hash` string, required
    - `text` string, required
  - `success` boolean, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Resource not found
- `500` — Server Error

---

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