← Back to Skills Marketplace
dommholland

GetPost Email API

by domm · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
170
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install getpost-email
Description
Send and receive emails via API. Get a working email address instantly.
README (SKILL.md)

GetPost Email API

Send and receive emails programmatically. No email server setup needed — get a working email address instantly on signup.

Quick Start

# Sign up (no verification needed)
curl -X POST https://getpost.dev/api/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "YOUR_NAME", "bio": "What your agent does"}'
# Save the api_key — you'll also get [email protected] automatically

Base URL

https://getpost.dev/api

Authentication

Authorization: Bearer gp_live_YOUR_KEY

Get an API Key

curl -X POST https://getpost.dev/api/auth/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "YOUR_NAME", "bio": "What your agent does"}'

You'll get [email protected] automatically.

Send Email

curl -X POST https://getpost.dev/api/email/send \
  -H "Authorization: Bearer gp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "[email protected]", "subject": "Hello", "body": "Email body text"}'

Cost: 1 credit per email sent.

Read Inbox

curl https://getpost.dev/api/email/inbox \
  -H "Authorization: Bearer gp_live_YOUR_KEY"

Returns received emails with from, to, subject, body, and attachments.

Register Dedicated Address

curl -X POST https://getpost.dev/api/email/addresses \
  -H "Authorization: Bearer gp_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"local_part": "hello", "domain": "quik.email"}'

Custom Domain Email

Register a domain via /api/domains/register, then create any email address on it.

Webhook

Register a webhook for email.received to get notified instantly when you receive email.

Full Docs

https://getpost.dev/docs/api-reference#email

Usage Guidance
This skill appears to be a plain instruction sheet for the GetPost email API and will work by having the agent run HTTP requests with your GetPost API key. Before installing: (1) Be aware the SKILL.md requires an API key (Authorization: Bearer gp_live_YOUR_KEY) but the registry metadata did not declare any required credentials — you will need to provide and store the key yourself. (2) The skill's source/homepage is not provided; verify the getpost.dev service and its privacy/security practices before giving it an API key. (3) If you allow autonomous invocation, the agent could send emails or read inbox messages using your key — consider restricting the skill to user-invoked only or limiting the key’s permissions/credits. (4) Webhooks will deliver incoming email data to whatever endpoint you register, so avoid exposing sensitive content to public endpoints. (5) Monitor usage/costs (the docs mention 1 credit per sent email) and be prepared to revoke the API key if you see unexpected activity.
Capability Assessment
Purpose & Capability
The SKILL.md describes a legitimate purpose (send/receive email via getpost.dev) and the curl examples show exactly how to do that. However, the registry metadata lists no required environment variables or primary credential, while the instructions explicitly require an API key (Authorization: Bearer gp_live_YOUR_KEY). The absence of a declared API key in the metadata is an inconsistency.
Instruction Scope
The runtime instructions are scoped to calling the GetPost HTTP API (signup, send, inbox, addresses, domains, webhooks). They do not instruct reading local files, system config, or unrelated environment variables. Webhook registration and handling are mentioned, which implies receiving external data but is consistent with email functionality.
Install Mechanism
No install spec or code is included (instruction-only). That limits disk persistence and reduces supply-chain risk.
Credentials
Functionality legitimately requires an API key and potentially webhook endpoints; those are proportionate to the task. But the skill metadata did not declare any required env vars or a primary credential — an omission that prevents automated policy checks and hides where secrets should be stored. Also, webhooks will send external email contents to whatever URL you register, which is a data-exfiltration surface to consider.
Persistence & Privilege
always is false and there is no install or system modification. The skill can be invoked autonomously by the agent (disable-model-invocation is false), which is platform default and normal, but note that autonomous use plus a stored API key would allow the agent to send/receive emails without manual approval.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install getpost-email
  3. After installation, invoke the skill by name or use /getpost-email
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of getpost-email skill. - Instantly create and use a functional email address via API—no server setup required. - Send and receive emails using simple authenticated API calls. - Features include inbox retrieval, sending emails, dedicated address registration, webhook support, and optional custom domain setup. - See full API documentation for details: https://getpost.dev/docs/api-reference#email
Metadata
Slug getpost-email
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is GetPost Email API?

Send and receive emails via API. Get a working email address instantly. It is an AI Agent Skill for Claude Code / OpenClaw, with 170 downloads so far.

How do I install GetPost Email API?

Run "/install getpost-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GetPost Email API free?

Yes, GetPost Email API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GetPost Email API support?

GetPost Email API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GetPost Email API?

It is built and maintained by domm (@dommholland); the current version is v1.0.0.

💬 Comments