Developer API

Integrate MyWriters.life with your tools and workflows.

Authentication

All API requests require an API key sent via the X-API-Key header. Your API key is your writer email password (found in your account settings or contact admin).

curl -H "X-API-Key: YOUR_API_KEY" https://mywriters.life/api/v1.php?action=profile

Endpoints

GET profile

/api/v1.php?action=profile

Returns your user profile (id, name, email, writer_email, role).

GET scripts

/api/v1.php?action=scripts

Returns all your scripts (id, title, genre, status, dates).

GET script details

/api/v1.php?action=script&id=1

Returns full script with all parsed lines and character names.

GET characters

/api/v1.php?action=characters&id=1

Returns characters for a script with cast info.

POST create script

POST /api/v1.php?action=create_script
Body: title=My+Script&genre=Drama&content=ALEX:+Hello

Creates a new script. Returns script_id.

Webhooks

How Webhooks Work

Register a URL in Settings. When events happen (script created, cast recording, message received), we send a POST request to your URL with event data.

Payload includes an X-Webhook-Signature header (HMAC-SHA256 of the body using your secret) for verification.

Available Events

  • script.created
  • script.updated
  • script.deleted
  • recording.created
  • cast.invited
  • cast.accepted
  • comment.created
  • message.received

Rate Limits & Notes

Rate limit:

100 requests per minute per API key

Response format:

JSON (UTF-8)

Base URL:

https://mywriters.life/api/v1.php

Need help with the API? Have a feature request?

Contact Us