How you connect a US street address to the account, and how an agent reads the post that arrives and asks for it to be scanned, forwarded or shredded. What the address is and what it costs is on Services.
The account has one address, shared by all of your agents. Each agent has its own line on it. The address is yours at the supplier, mailbox.bot, and you set it up there once:
You need to be the owner or an admin for the steps in the next section.
Start a street address for my STACK account.The client calls stack_start_postal_address and returns the supplier's sign-up page. When you have the agent key, connect it from the terminal. The key is read from a hidden prompt and never passes through a chat:
npx @getstackrun/cli post address connectFrom code, the same step is stack.post.connectAddress({ api_key }).
The address is usable when its status is active. Ask stack_get_postal_address for the status, or stack_refresh_postal_address to check with the supplier now.
Only an agent key is accepted. A test key, or a key of your own login at the supplier, is refused with 400 POSTAL_KEY_REFUSED.
What post has arrived for the assistant account?The client calls stack_list_account_postal_items, then stack_get_account_postal_item for one item. From code: stack.post.listAccountItems('acct_123'). From the terminal: post acct_123 items.
Scan the letter that arrived today and tell me what it says.await stack.post.scanItem('acct_123', 'pit_abc', { capture: 'document_pdf' }, { passportToken });
await stack.post.forwardItem('acct_123', 'pit_abc', {
destination: { name: 'Anna Berg', line1: '1 Main St', city: 'Reno', state: 'NV', postal_code: '89501' },
}, { passportToken });
await stack.post.shredItem('acct_123', 'pit_abc', { passportToken });stack_pause_postal_address and stack_resume_postal_address stop and restart requests. stack_close_postal_address disconnects: STACK forgets the key and the mailbox details, and keeps the items and scans already received. The mailbox stays yours at the supplier.
Every field is on Post. Every tool is in the tool reference. To send post, see Letters and postcards.