Send the article and track the placement

Check the article first

• A Google Doc: run workflow_verify_doc. Critical checks: the anchor text is there, the target URL is linked exactly once and from the anchor, and no placeholder text is left. It also warns about structure and word count. It is free.
• Your own article on another page (Notion, your site): Linkio does not read its text. Check it yourself.
• The publisher must be able to open the link without a login.

Send it

In the app: in the order, find the row of the site. In the Publisher column, select Send. The panel shows the seller and the email that Linkio sends. Read it and change it if necessary. The first time you send, the app asks you to Complete Your Billing Profile: your company name and how you take payment details. The publisher sees your company name. Select Confirm & Send.

With an agent: workflow_send_to_publisher sends it, the same as the Send button. Call it first with checkOnly: true: that is a dry run. It reports what the send would do and sends nothing. Send only after you approve.

After the send the publisher gets an email with the article link. The status of the placement becomes article_ready. The publisher's reply comes back into the same thread.

Talk to the publisher

• Read the thread: line_item_conversation_read (everything you, the publisher and Linkio said, oldest first). In the app, a reply shows as new on the order row, and all messages are under Messages.
• Write: line_item_message_publisher. It is emailed from your company name through Linkio. For several sites with the same publisher, pass lineItemIds (at most 50): one email lists each site.

Track every placement

Do not read each placement one by one. Use one of these:

• The activity feed. account_activity_feed lists what happened on the whole account: status changes, messages, orders, payments, charges, holds, approvals and placement changes. Filter by types, days or orderId. It is free. In the app: https://www.linkio.com/account/activity. The event types are on Statuses and what you do now.
• The operations view. line_items_operations shows your sites across all orders by where they stand with the publisher. view: summary gives the counts. staleDays finds the placements that have been quiet for that many days.

Each key has a daily read limit (DAILY_READ_CAP). Reads of your own data are free, and a status sweep once an hour uses a few hundred reads a day. Check the account once an hour, not in a loop.

Next

The publisher puts the article live and sends the URL. Then check it and pay: Check the live link and pay the publisher.