1
Create a machine user
Go to Agents and click Add agent under Connected agents. This creates a machine user with the type Agent, which is the type for any agent you build.You can also go to Settings → Machine users & agents and click Add machine user. Plain asks what kind of machine user to make: pick Agent, or API User for integrations that only call the API, then click Continue.
- Name is only visible to your team, for example “Billing agent”
- Public name is what customers see when the agent replies, for example “Acme Support”
- The avatar is shown to you internally and, if your agent interacts with customers, publicly as well.
2
Create an API key
Click Add API key and grant the permissions the agent needs. Each page in this section lists the permissions for its calls. A mutation without the right permission returns an error that names the missing one.Plain shows the key once, so you should copy it when it is created.A machine user can hold more than one key, so you can rotate without downtime.Read more on GraphQL authentication
3
Set up webhooks
Go to Settings → Webhooks and click Add webhook target. Point it at an HTTPS endpoint you control and subscribe to the events you need. You can update these later as you build your agent.Read more on working with webhooks.
Building your agent
With the above basic steps, you can now build your agent. Agents can do anything in Plain. You should pick where you want to start based on the use case for your agent.Assisting your team
Make your agent available to your team directly within Plain to chat and assist them.
Doing support autonomously
Let your agent handle threads autonomously end to end.

