topics

Create a subscription topic.

default_subscribed=false makes it opt-in: silence means no.

post/topics

Request

  • Base URL: https://api.agentisend.com
  • URL: https://api.agentisend.com/topics
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Makes this call safe to retry. Send the same key with the same body and the original response is replayed instead of the work happening twice. Keys are 1-256 characters and are remembered for 7 days. While the first attempt is still running, a second call with that key returns 409 idempotency_in_flight (Resend calls this concurrent_idempotent_requests); the same key with a different body returns 409 idempotency_payload_mismatch (Resend: invalid_idempotent_request). Resend-Idempotency-Key is accepted as the same header.

Resend-Idempotency-Keystring

Alias of Idempotency-Key. Idempotency-Key wins if both are sent.

Request body

namestring required

A name for the topic list. Unique on this account.

descriptionstring

Shown with the topic when a contact chooses.

default_subscribedboolean

true sends this topic unless the contact opts out. false means silence is no. Same as default_subscription: opt_in is true, opt_out is false.

visibility'public' | 'private'

public lists the topic on every preference page. private lists it only for contacts subscribed to it. Defaults to public.

Response

Success

object'topic' required
idstring uuid required
namestring required
descriptionstring nullable required
default_subscribedboolean required
default_subscription'opt_in' | 'opt_out' required
visibility'public' | 'private' required
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.