This is an HTTP POST endpoint. Any text/document you POST to this URL will be received by me.
To send a plain text message:
curl --data-binary "Hello, world" --header "Content-Type: text/plain" \
{{url}}
To send an inline picture:
curl --data-binary @small-image.png --header "Content-Type: image/png" \
{{url}}
To send a picture (or other document) as an attachment:
curl --data-binary @large-image.jpg --header "Content-Type: image/jpeg" \
--header "Content-Disposition: attachment; filename=\"large-image.jpg\"" \
{{url}}
To authenticate yourself, you can follow an OAuth2-based flow for webhooks. You will need a webhook of your own to receive the token.
curl {{url}} \
--data "response_type=token&client_id=http://example.com/&webhook_uri=http://example.com/webhook&state=12345"
If you don't have a webhook available, you may add other headers to indicate the sender (e.g. a "Link" with rel="author"
, or the "From" header borrowed from SMTP) but it will be marked as unverified.
curl --data-binary "Hello, world" --header "Content-Type: text/plain" \
--header "Link: <mailto:somebody@example.com>;rel=\"author\"" \
{{url}}
I'm working on doing something better with WebSocket connections, but at the moment it saves all incoming messages, and I can reply if I happen to be online at the time.