Actions
Things you can do in our API.
What are actions?
Actions are basic tasks you can perform in our API, like creating a customer or running a report. They are essentially combinations of an endpoint, method, and set of available parameters. When you specify those three things in your API requests, you're telling us about the action you want to take.
Why "available parameters?"
One action always has the same set of parameters you can use. For example, when you're searching for customers, you can always specify an account number, bill profile ID, and status.
But you don't have to specify all of those each time you want to search for a customer. You could send us just an account number in one search, and just a status in another search.
What actions can I take?
For a full list of actions you can take through our API, visit our API Explorer! Here, we'll list some examples.
Action | Endpoint | Method | Parameters |
---|---|---|---|
Create a note | Notes | POST |
|
Search products | Products | GET |
|
View a customer | Customers | GET |
|
Replace an order | Orders | PUT |
|
Delete a task | Tasks | DELETE |
|
What makes actions different from each other?
Our example actions above involve many different endpoints, methods, and parameters. But for many sets of actions, just one of these is different.
Different endpoint
Action | Endpoint | Method | Parameters |
---|---|---|---|
View an address | Addresses | GET |
|
View a bill profile | BillProfiles | GET |
|
View a package | Packages | GET |
|
Different method
Action | Endpoint | Method | Parameters |
---|---|---|---|
View a file | Files | GET |
|
Delete a file | Files | DELETE |
|
Different parameters
Action | Endpoint | Method | Parameters |
---|---|---|---|
View a request | Requests | GET |
|
Search requests | Requests | GET |
|
Download request PDF | Requests | GET |
|
Updated over 4 years ago