How do I write and publish my first article?

Create a free account, create an agent key, write an article with POST /api/v1/articles, then publish it as a draft to your site. A free account starts with enough credits for your first articles and needs no card. Generation takes 45 seconds to 6 minutes depending on length.

What do I need first?

A free TalkGenAI account: sign up.
A connected site if you want to publish. Connect it in the dashboard. You can generate an article without a site and get the HTML back.
An agent key, created in the dashboard under Integrations, Connect your agent, + New Agent Key. It starts with tgai_. Treat it like a password.

How do I do it?

Set your key

export TALKGENAI_API_KEY=tgai_your_key_here
AUTH="Authorization: Bearer $TALKGENAI_API_KEY"

List your sites

curl -s -H "$AUTH" https://app.talkgen.ai/api/v1/sites

Copy the connection_id of the site you want. If count is 0, connect a site in the dashboard first.

Start the article

JOB=$(curl -s -X POST https://app.talkgen.ai/api/v1/articles \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"title":"How to choose a CRM for a 5-person agency","length":"medium"}' \
  | jq -r .job_id)

This costs 5 credits and returns a job_id immediately.

Wait until it is completed

curl -s -H "$AUTH" https://app.talkgen.ai/api/v1/articles/$JOB

Poll every 10 seconds until status is completed.

Save it as a draft on your site

curl -s -X POST https://app.talkgen.ai/api/v1/articles/$JOB/publish \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"connection_id":"wpc_abc123"}'

The response has an edit_url. Open it, review the draft and publish it yourself.

How do I check that it worked?

The publish response contains "status": "draft", a post_url and an edit_url. Open the edit_url on your site and you will see the article with its headings, FAQ block and, if you asked for one, the featured image.

Can my agent do this for me instead?

Yes. Connect your agent over MCP and ask it: “Write a post about X and publish it as a draft to my site.” Pick your client: Claude Code, Cursor, Claude Desktop or OpenClaw.

What can go wrong?

Symptom	Cause	Fix
`401 unauthorized`	Key missing or revoked	Create a new key in the dashboard
`403 insufficient_credits`	Not enough credits	Check credits
`400 not_ready`	Article still generating	Keep polling
`403 domain_mismatch`	You used a WordPress plugin key	Use an agent key

All error codes are on the Errors page. Last updated: 2026-10-05

Create your free account

Create an agent key in about two minutes.

Start here

Quickstart: write your first article

How do I write and publish my first article?

What do I need first?

How do I do it?

How do I check that it worked?

Can my agent do this for me instead?

What can go wrong?

Create your free account

​How do I write and publish my first article?

​What do I need first?

​How do I do it?

​How do I check that it worked?

​Can my agent do this for me instead?

​What can go wrong?

Create your free account

​Related

How do I write and publish my first article?

What do I need first?

How do I do it?

How do I check that it worked?

Can my agent do this for me instead?

What can go wrong?

Related