Skip to content
AR Edara website

Integrating with the Couriers "Bosta" and "Aramex"

Last updated: November 11, 2026

Instead of entering every shipment by hand on the courier's website and following it there, you can connect "Shipping Manager" to your "Bosta" or "Aramex" account, or both, so shipments are sent to the courier directly and the status of every shipment comes back to you. This saves your team's time and avoids mistakes from re-typing customers' details and addresses.

Follow the Steps

You connect "Shipping Manager" to each courier on its own from the "Integrations" page, and with "Bosta" you finish by registering the webhook URL and mapping the cities:

Connecting "Bosta"

  • Go to "Integrations".
  • Click "Configure" on the "Bosta" card.
  • Enter the "Bosta API Key". You'll find it in the Bosta merchant portal → Settings → API Integration.
  • Click "Test Connection" and wait for "Connected".
  • Click "Connect".

"Active" appears on the "Bosta" card, and the shipments you create start reaching your "Bosta" account.

Note: Turn on "Allow open package" if you want the receiver to open and inspect the package before accepting it. This applies to new deliveries only.

Registering the Webhook URL in "Bosta"

To get the status of every shipment from "Bosta" automatically, register the webhook URL in your "Bosta" account:

  • Click "Manage" on the "Bosta" card.
  • In "Webhook Configuration", click the copy icon next to "Webhook URL".
  • In the Bosta merchant portal, go to Settings → API Integration → Set Up Your Webhook, and paste the URL.

Note: If you added an Authorization Key in "Bosta", click "Change Credentials" and enter the same value in "Webhook Secret".

Mapping the Cities with "Bosta"

Link each "Edara" city to its "Bosta" city, so shipment addresses resolve without guessing from names:

  • Click "Manage" on the "Bosta" card, then "Manage mapping".
  • Click "Sync from Edara". Similar cities are linked automatically and show as "Unreviewed".
  • Review each linked city and click ✓ to confirm it.
  • For "Unmapped" cities, select the "Bosta" city, then click ✓.
  • Ignore the cities you don't ship to, then click "Done".

Note: Districts aren't mapped here; each district is matched by name when the shipment is created. If it can't be matched, pick it once in the create shipment window and it's used automatically next time.

Connecting "Aramex"

  • Click "Configure" on the "Aramex" card.
  • Leave "Test Mode" on to try the connection without real shipments, or turn it off to switch to "Production Mode".
  • Enter the "API Credentials": username and password.
  • Enter the "Account Details": account number and account PIN, and check the account entity and country code.
  • Enter the "Origin Settings": origin city, sender details and pickup address.
  • Click "Test connection", then "Save & Connect".

Note: You'll find your credentials in the Aramex Merchant Portal under API Settings. In "Test Mode", requests go to the Aramex sandbox and no real shipments are created, so switch to "Production Mode" when you're ready to ship for real.

Pausing or Disconnecting an Integration

  • Pause: the integration stops for now and "Paused" shows on the card, with its settings kept. Click "Resume" to start it again.
  • Manage: to edit the credentials and settings.
  • Disconnect: click the disconnect icon, then confirm with "Disconnect". To connect again, click "Configure".

Important Things to Know

  • The "Integrations" page is for admins only.
  • Click "Test Connection" before saving to make sure the credentials are right.
  • Register the webhook URL in "Bosta" so shipment status updates reach you automatically.
  • Cities linked automatically are used in shipments but are only a best guess, so review and confirm them.
  • "Allow open package" applies to new deliveries only.
  • "Test Mode" in "Aramex" doesn't create real shipments.

Try It Yourself

Sample data — it doesn't affect any real data. Click "Configure" on the "Bosta" or "Aramex" card, click any field to type a sample value, then test the connection and connect. Once connected, try "Manage", "Manage mapping", "Pause" and disconnecting.

You May Be Wondering

Where do I find the Bosta API key?
In the Bosta merchant portal → Settings → API Integration.
Can I connect "Bosta" and "Aramex" together?
Yes. Each courier has its own card in the "Integrations" page, and you can connect both.
What's the difference between "Pause" and "Disconnect"?
"Pause" stops the integration for now and keeps its settings, so you bring it back with "Resume". "Disconnect" removes the connection, and you need "Configure" again to bring it back.
What happens to the cities I didn't map?
They're matched by name when the shipment is created. If that fails, you pick the city in the create shipment window.

If you encounter any challenges or have questions during these processes, you can contact our technical support team, who are ready to assist you at any time.

Shipping Manager Installing the "Shipping Manager" Extension and Setting It Up for the First Time