Skip to main content
Links a merchant account so the agent can shop and check out there. Cooperative merchants (Rappi) reply that a one-time code was sent, which you finish with buy_confirm_merchant; learned merchants (Good Eggs, DoorDash) link in one step, and DoorDash needs the user’s captured browser session.
Not advertised in tools/list by default — the buy tool covers this conversationally. Expert integrations can still call it by name.

​
Parameters

ParameterTypeRequiredDescription
merchantstringYesMerchant slug (rappi, goodeggs, or doordash).
emailstringYesEmail for the merchant account.
first_namestringYesFirst name on the merchant account.
last_namestringYesLast name on the merchant account.
phonestringYesPhone number for the merchant account.
captured_sessionobjectNoDoorDash only: cookies captured client-side.

​
Returns

On a one-step link, confirmation that the merchant is linked and ready to shop. Cooperative merchants return a “code sent” message (with the masked destination) plus the merchant and pending_id to pass to buy_confirm_merchant along with the code the user received. Failures return a short error message.

​
Example

{ "name": "buy_link_merchant", "arguments": { "merchant": "rappi", "email": "sam@example.com", "first_name": "Sam", "last_name": "Rivera", "phone": "+14155550123" } }