Would you rather we walk you through it? Most warehouses set this up on a short screen share with our team. Email support@owlery.ai and we’ll arrange one. The steps below are here if you’d prefer to work through it yourself.
What This Setup Does Not Involve
- No development work: Owlery uses Extensiv’s standard REST API. There is nothing to build.
- No software to install: nothing is added to your 3PL Warehouse Manager account.
- No data exports: Owlery reads your account directly. You never assemble spreadsheets of sample records for us.
- No ongoing maintenance: Owlery refreshes its access token automatically every hour. Once access is granted, it keeps working.
Before You Start
The request form asks for two things you’ll need to collect first.1. Your Account TPL Number
In the Support Portal, go to Account and find the Account Information section. Your TPL number is listed there.2. A Dedicated Integration User
Integrations with Extensiv require its own user account. In the Support Portal, select Users in the left sidebar, click Create User, and fill it in:Which role you assign depends on which version of Extensiv / 3PL Central your account is on — older versions use
cust6, newer ones use a full access role. If only one of the two is available to you, that’s the one.Submitting the Request Form
Extensiv’s professional services team handles API access requests through a single form.Extensiv API Integration Request Form
Fill this out once you have your TPL number and your integration UserID.
What Happens Next
Extensiv’s professional services team reviews the request and issues the API credentials. If those come back to you rather than to us, forward them to support@owlery.ai. We verify the connection and start the first sync.What Owlery Syncs
Once access is in place, syncing runs on its own. Each cycle pulls only the records created or changed since the last run, so the connection stays incredibly light on your Extensiv instance. We read these two main data types, along with related objects so your dock operations has full visibility into what is coming and going (locations, line items, and PO numbers/reference numbers).- Inbound Receivers: Receivers are Extensiv’s inbound shipments. We read these to validate appointments for your inbound shipments.
- Outbound Orders: Outbound Orders are Extensiv’s outbound shipments. We read these to validate appointments for your outbound shipments.
Keeping the Connection Healthy
Owlery is built to stay well within Extensiv’s API limits and to avoid unnecessary traffic against your instance:- Automatic token refresh: Owlery requests an access token and refreshes it every hour. There is nothing for your team to renew or rotate.
- Throttled requests: Owlery caps its own request rate to stay inside Extensiv’s limits.
- Fewer round trips: line items come back inline with the list request instead of one call per record.
- Incremental sync: every cycle filters by last modified date, so unchanged records are never re-fetched.
Technical Reference
Everything below is handled by Owlery. It’s here for teams who want to see exactly what the integration touches.Authentication
Authentication
Owlery requests an access token from Extensiv’s token endpoint and refreshes it hourly. All subsequent calls use that token.
Endpoints Owlery calls
Endpoints Owlery calls
Sync behavior
Sync behavior
- Base URL:
secure-wms.com - Incremental sync filters on
LastModifiedDate. - List requests pass
Detail=ReceiveItemsorDetail=OrderItemsto return line items inline. - Owlery throttles its own requests to roughly 5 per second.
Getting Help
Not sure whether you have Support Portal access, or would rather we run the setup with you? Email support@owlery.ai.Related Settings
- Set up your facility profile: Owlery maps your Extensiv facilities to these sites, so keep addresses and dock details current.
- Set up dock appointment settings: operating hours, appointment length, booking rules, and notifications.