Add tag API
For third-party systems posting tags into a hosted RemoteTagPro account.
Your client will give you an integration key, company ID, and list of valid store IDs.
Request
POST https://remotetagpro.com/api/addTag.php
HTTPS only. A User-Agent is required. A blank User-Agent is rejected before this page runs.
X-Api-Key: the-integration-key Content-Type: application/x-www-form-urlencoded User-Agent: YourApp/1.0
Do not put the key in the body. X-Api-Key is the authorization header.
| Field | Required | Notes |
|---|---|---|
| coID | yes | 6-digit company ID |
| pStoreID | yes | store ID, max 20 characters, must be active |
| pName | yes | product name (full text to display for the product) or message text |
| pClass | no | class or category |
| pPrice | no | cash price; 0 used for message tags |
| ccPrice | no | card price; omit or 0 |
| used if included, if omitted or 0 then RemoteTagPro calculates if Dual Pricing Selected | ||
| pUPC | no | use a real UPC for price and stock tags; 0 is fine for a message |
| pStockTag | no | 0–100, default 0. Stock Label (prints pUPC + pName) omits Pricing, will print this many copies |
| pMessage | no | 1 = message tag. If stock is greater than 0, message is cleared |
What gets stored
- Price tag: skipped if the last price row for that UPC, store, and company has the same name, cash price, and card price.
- Stock tag and message tag: always inserted.
- Printed tags older than 3 days are removed by the morning cleanup.
Responses
200 {"ok":true,"inserted":true,"id":123}
200 {"ok":true,"inserted":false,"reason":"unchanged"}
400 missing fields
403 bad key, inactive store, or inactive company
405 not POST
500 server error
Example
curl -X POST "https://remotetagpro.com/api/addTag.php" \ -H "X-Api-Key: YOUR_INTEGRATION_KEY" \ -H "User-Agent: VendorPOS/1.0" \ -d "coID=234851" \ -d "pStoreID=4" \ -d "pName=Test Product" \ -d "pPrice=19.99" \ -d "ccPrice=20.59" \ -d "pUPC=709215302120" \ -d "pStockTag=0" \ -d "pMessage=0"
The integration key is shown once in the account portal. RemoteTagPro desktop uses a different, shorter app key and does not call this endpoint.