How to Connect PayPal to an AI Agent: Step-by-Step Guide
· DoubleX
Quick answer
To connect PayPal to an AI agent, create an account, open the Connectors screen, authorize PayPal, then choose which actions the agent can run, starting read-only. In DoubleX Agentes, you test with a read request and the agent asks for confirmation before changing anything.
Connecting PayPal to an AI agent takes a few minutes, but the choices you make during setup matter more than the connection itself. The key decision is what the agent may read and what it may change. This guide walks through the practical path, with a focus on permissions and control.
What can the PayPal connector let an agent do?#
The PayPal connector lets an agent manage invoices, orders, payments, and disputes. A connector is a system linked to the platform, and the agent uses that system's tools to do work for you.
In practice, that means an agent can look up a payment, check the status of an invoice, or review an open dispute. Depending on the actions you enable, it can also create or change records. You decide where that line sits, as explained below.
| Area | What the agent can reach | Typical access to start |
|---|---|---|
| Invoices | Invoices and their status | Read only |
| Orders | Orders in your PayPal account | Read only |
| Payments | Payment records | Read only |
| Disputes | Open and past disputes | Read only |
For ideas on what to ask once it is connected, see what to automate in PayPal with AI.
What do I need before connecting?#
You need a DoubleX Agentes account, a PayPal account you are allowed to authorize, and a clear idea of which agent will use it. Creating the account is free and requires no credit card.
Before you start, check these items:
- Access to the PayPal account, with permission to approve a third-party connection.
- An agent for the finance or billing area, or the diagnostic to create one. The diagnostic is a 5 to 10 minute conversation with the product's AI consultant about your routine, and the first one is free.
- A decision on who should own the connection: only you, your team, or the whole company.
How do I connect PayPal on the Connectors screen?#
Open the Connectors screen, choose PayPal, and authorize access with your PayPal account. After that, the connector is available to your agents.
- Sign in to DoubleX Agentes, or create a free account and answer the onboarding questions about your business.
- Create your agent on the Agents screen, or run the diagnostic and turn the result into a ready-to-test team of agents.
- Open the Connectors screen and select PayPal.
- Authorize PayPal when prompted, signing in with the account you want the agent to use.
- Choose the scope of the connection: personal, team, or company.
- Attach PayPal to the agent that should use it and set its permissions (next section).
Authentication details such as passwords, tokens, and keys are stored encrypted with AES-256-GCM. If you want to manage connectors programmatically, see the Connectors API reference.
How do I choose what the agent can read and change?#
For each agent, you pick which systems it uses and, within each system, which actions it may run. Actions that change data can stay switched off, leaving the agent read-only.
A safe approach is to grow permissions in stages:
| Stage | What is enabled | Good for |
|---|---|---|
| 1. Read only | Look up invoices, orders, payments, disputes | Checking status, summaries, reviews |
| 2. Selected actions | Only the specific actions you turn on | Narrow, well-understood tasks |
| 3. Broader actions | More actions, still with confirmation | Routines you have tested several times |
Permissions are set per agent, so a support agent can have different access than a finance agent. Each area of the company can have its own agents with their own instructions, systems, and permissions.
How do I test the connection with a safe first request?#
Test with a request that only reads data. If the agent returns correct information from your PayPal account, the connection and permissions are working.
Try one of these requests:
- "List the last 10 PayPal payments and show the amount and status of each."
- "Which PayPal invoices are still unpaid?"
- "Show any open PayPal disputes and what each one is about."
- "Find the PayPal order for this customer and tell me its current status."
Compare the answer with what you see in PayPal itself. If something is missing, check that the connector is attached to the agent and that the read actions are enabled. The Quickstart covers the basic flow if you are new to the platform.
How does the agent ask for confirmation and log what it did?#
Before sending, deleting, or changing anything in your systems, the agent asks for confirmation and shows the step-by-step of what it did. Everything is recorded in the history of the task.
Each request to an agent becomes a task on the Tasks screen. The history includes the request, every tool the agent used, and the result. That lets you see who asked, what was done, and when.
To review a task:
- Open the Tasks screen.
- Select the task you want to check.
- Read the tools the agent called and the final result.
Routines run with the permissions of the person who created them, so create scheduled work from an account with the access level you actually want the agent to have.
Frequently asked questions#
Is it safe to connect PayPal to an AI agent?#
You control the risk through permissions: choose which actions the agent can run and keep data-changing actions off if you want read-only access. Credentials are stored encrypted, and company content is not used to train models.
Can the agent change or send things in PayPal without asking?#
No. Before sending, deleting, or changing anything in your systems, the agent asks for confirmation and shows what it did step by step.
Do I need to code to connect PayPal?#
No. You connect it from the Connectors screen and describe what you need in your own words. Developers who want more can use the REST API, the CLI, or the MCP server.
Can I connect PayPal for my whole team?#
Yes. A connection can be personal, for a team, or for the whole company. Roles of owner, admin, and member also help control who can do what.
Where can I see what the agent did?#
On the Tasks screen. Each task keeps the request, every tool the agent used, and the result.
Related guides
- How to Connect Box to an AI Agent: Step-by-Step GuideLearn how to connect Box to an AI agent: set up the connector, limit it to read-only, choose who can use it, and check the history of your first request.
- How to Connect Jam to an AI Agent: Step-by-Step GuideLearn how to connect Jam bug reports to an AI agent in DoubleX Agentes: set up the connector, pick who can use it, limit permissions, and run a first test.