Agent credentials vs your own credentials

What our shared agent credentials cover, which data needs your own supplier login (like SanMar pricing and stock), and how to switch.

Product
PSRESTful, PromoSync
Plan
Every plan
Updated
November 2026

Agent credentials are logins that suppliers gave PSRESTful so we can pull their catalog data for every account. Your own credentials are the login a supplier issues to your company. You need yours for anything specific to your account with that supplier, and for a few suppliers, SanMar included, for pricing and stock as well.

What agent credentials cover

When a supplier shows a check under Credentials Available (the Creds column) on the Integrated Suppliers page, our agent credentials work for:

  • Product Data: the full catalog
  • Media Content: images and documents
  • Pricing & Configuration (PPC): net and list prices only
  • Inventory: stock levels

This is the same data for every distributor, so one shared login does the job. There's nothing to set up. If your account has no credentials saved for a supplier, we use ours automatically, as long as we have them for that supplier.

The prices you get this way are the supplier's net and list prices, not the pricing you've negotiated.

What needs your own credentials

Anything tied to your business with the supplier:

  • Your negotiated (customer) pricing
  • Purchase orders
  • Order status
  • Shipment notifications
  • Invoices

The supplier has to know who's asking to return your prices, your orders and your invoices, so a shared login can't do it.

Some suppliers also refuse shared logins for part of the catalog. SanMar is the one most people hit: under SanMar's agreement with us, its pricing and inventory only come through for accounts with their own SanMar login. Product data and images still work without one. On the Integrated Suppliers page this shows as a check with "except", like "except INV, PPC". In the Data Explorer you'll see "SanMar requires your own credentials for this service." Get your SanMar credentials walks through it.

If a supplier has no check under Credentials Available, we don't hold a shared login for it, so you need your own for everything.

Switching to your own

Save your login on the Supplier Credentials page (how to add them). From the next call on, your account uses your login for that supplier, for every service, including product data and images.

Warning

Once your own login is saved for a supplier, we stop using our agent credentials for it. If your login is wrong, even product data and images for that supplier will fail. Click the play button (Test credentials) on the row right after you save.

To go back to our agent credentials, delete your row for that supplier with the trash icon. Delete All does this for every supplier at once.

Still waiting on a supplier's reply? If that supplier shows Credentials Available, you can start now: leave it off your Supplier Credentials page, work with our agent credentials, and add your login when it arrives.

For developers

When a service needs your own credentials and the account has none, the API answers 403 with a detail message, for example "SanMar requires your own credentials for the INV service. Please add your SanMar credentials to your PSRESTful account." Order status, shipment notification, invoice and purchase order calls answer 403 "You don't have access based on your credentials", and PPC with price_type=Customer answers 403 "Your account needs credentials for <supplier> Customer pricing".

Did this answer your question?

Tell us in your own words, or paste the error. It goes to our team with this article attached.