Magento 2 + AtoShip

How it works

Magento 2 has a built-in Integration feature that supports OAuth 1.0a. You create an Integration inside your Magento admin, paste in two URLs from atoship, and click Activate. Magento and atoship exchange tokens automatically — no coding, no extensions, no API keys to copy-paste.

Setup

Step 1 — Create a new Integration

In your Magento admin, go to System → Integrations and click Add New Integration.

NameAtoShip

Callback URL

https://atoship.com/api/channels/magento/callback

Identity Link

https://atoship.com/api/channels/magento/identity

Fill in the Name, Callback URL, and Identity Link URL. The Email field is optional.

Step 2 — Set API permissions

Click the API tab on the left. Under "Resource Access", either select All or grant access to these specific resources:

• Sales — Orders, invoices, shipments, credit memos
• Catalog — Products (for weights & dimensions)
• Stores — Store configuration & views

Tip: "All" is the simplest option and ensures all sync features work. You can restrict it later if needed.

Step 3 — Save and Activate

Click Save to create the Integration. Then find it in the list and click the Activate link. Magento will ask you to confirm — click Allow.

Important: Make sure you're logged into your atoship account in the same browser before clicking Activate. Magento redirects your browser to atoship's Identity Link URL, and atoship needs your session to associate the store with your account.

Step 4 — Verify the connection

After clicking Allow, you'll be redirected back to your atoship dashboard's Channels page with a success message. Your Magento store should appear in the list with an "Active" status.

Alternative: Manual token entry

If you've already created an Integration and have the 4 API tokens (Consumer Key, Consumer Secret, Access Token, Access Token Secret), you can enter them directly:

1. Go to atoship → Channels → Add Channel → Magento
2. Switch to the Manual Tokens tab
3. Enter your store URL and all 4 tokens
4. Click Connect

This is useful if your Magento store can't reach the internet (e.g., staging environments behind a firewall) or if you prefer to manage tokens manually.

What gets synced

Disconnecting

You can disconnect from either side:

• From atoship: Go to Channels, find your Magento store, and click Disconnect.
• From Magento: Go to System → Integrations, find "AtoShip", and click Delete or Reset.

Disconnecting does not delete any orders or shipments already synced. It only stops future sync.

Troubleshooting

Requirements