Getting Started
Quickstart
List profiles, create a post, and inspect delivery results.
1. List profiles
curl https://postmantis.com/api/v1/profiles \
-H "Authorization: Bearer $POSTMANTIS_API_KEY"Use an active profile id from response.
2. Create publish-now post
curl https://postmantis.com/api/v1/posts \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": { "body": "Launch is live." },
"profiles": ["PROFILE_ID"]
}'Save returned data.id.
3. Create scheduled post
curl https://postmantis.com/api/v1/posts \
-H "Authorization: Bearer $POSTMANTIS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"post": { "body": "Launch tomorrow.", "scheduledAt": "2026-03-30T12:00:00Z" },
"profiles": ["PROFILE_ID"]
}'4. Read result
curl https://postmantis.com/api/v1/posts/POST_ID \
-H "Authorization: Bearer $POSTMANTIS_API_KEY"Create returns accepted state. Read later for final provider result.