{"slug":"picqer-fulfilment-admin-and-scoped-api-keys","sourcePath":"picqer-fulfilment-admin-and-scoped-api-keys.md","title":"Picqer Fulfilment API-key scope and supplier data","status":"reviewed","editorialStatus":"customer-ready","publicationBlocker":"","publishable":true,"needsReview":false,"reviewReason":"","category":"integrations","lastReviewed":"2026-10-07","excerpt":"Start the support-assisted connection setup for Picqer Fulfilment from Optiply, and learn where to check the connection once setup is complete.","wordCount":593,"readingMinutes":3,"articleType":"Concept guide","qualityFlags":[],"searchText":"picqer fulfilment api-key scope and supplier data start the support-assisted connection setup for picqer fulfilment from optiply, and learn where to check the connection once setup is complete. picqer fulfilment api-key scope and supplier data purpose start the support-assisted connection setup for picqer fulfilment from optiply, and learn where to check the connection once setup is complete. optiply support completes the connection setup with you. contact support to start it. prerequisites open the optiply account where you want to use picqer fulfilment. these steps take place in optiply, not in picqer fulfilment. if settings or the add a source control is unavailable, contact support using the link above. steps 1. in optiply, open settings, then integrations. 2. wait for the source lists to finish loading. add a source is disabled while they load. 3. choose add a source and search for picqer fulfilment. 4. if the matching source is listed, select it. if it is not listed, contact support instead; do not select a different connector. 5. choose next to open connect to system. this guide stops before submitting any connection configuration. 6. contact support to start setup. if the screen offers contact us, use that control; otherwise use the support page. support completes the connection setup with you. 7. after setup, return to settings → integrations. check for the source name with the connected label in the linked-source list. fields and columns - source name: identifies the source shown in the selection menu and, once linked, in the integrations list. - add a source: opens the source-selection dialog; it does not itself complete the connection. - contact us: opens the support-contact action when that option is offered for the selected source. - connected: labels a source in the linked-source list. it does not by itself confirm that particular records have been transferred. expected result you have started setup with support and know where to check the linked source afterward. once the source is linked, integrations displays its name with the connected label. contacting support alone does not produce that label. limitations this guide covers optiply-side source selection and the support handoff only. it does not cover configuration inside picqer fulfilment, guarantee that the connector appears in every account's menu, or confirm when data will first arrive. the documented connector reference below is separate from connection setup and does not confirm your account configuration. errors and recovery if add a source is disabled, wait for the source lists to finish loading. if the connector is missing, the control is unavailable, or the expected linked source does not appear after setup, contact support. tell support which connector you want to connect or check. documented connector details the documented picqer fulfilment integration distinguishes scoped and admin api keys. their access differs, which affects how supplier data is handled. scoped key a scoped key is limited to one fulfilment customer's objects and cannot read supplier objects from picqer fulfilment. the documented integration has two supplier-handling modes: - with supplier-name mapping enabled, an incoming buy order can create an optiply supplier from the order's suppliername. - with that mapping disabled, incoming buy orders use the unknown supplier. do not assume which mode is enabled for your account. admin key an admin key has broader access across the picqer fulfilment organisation, including supplier objects. the documented admin-key mapping reads those supplier objects and updates them in optiply when they change in picqer fulfilment. before changing key type changing between scoped and admin keys changes the required data and configuration. contact optiply support before changing key type, without including the api key itself. this reference explains documented data scope. it does not confirm your key permissions, connection status or successful order upload. see picqer fulfilment warehouse data scope for the separate warehouse-selection reference. data mapping guide ask optiply support which mapping guide applies to the selected source before comparing fields or planning the transition.","customerSafe":true,"body":"# Picqer Fulfilment API-key scope and supplier data\n\n## Purpose\n\nStart the support-assisted connection setup for Picqer Fulfilment from Optiply, and learn where to check the connection once setup is complete.\n\nOptiply support completes the connection setup with you. [Contact support](/support) to start it.\n\n## Prerequisites\n\nOpen the Optiply account where you want to use Picqer Fulfilment. These steps take place in Optiply, not in Picqer Fulfilment. If Settings or the Add a source control is unavailable, contact support using the link above.\n\n## Steps\n\n1. In Optiply, open **Settings**, then **Integrations**.\n2. Wait for the source lists to finish loading. **Add a source** is disabled while they load.\n3. Choose **Add a source** and search for Picqer Fulfilment.\n4. If the matching source is listed, select it. If it is not listed, contact support instead; do not select a different connector.\n5. Choose **Next** to open **Connect to system**. This guide stops before submitting any connection configuration.\n6. Contact support to start setup. If the screen offers **Contact us**, use that control; otherwise use the [support page](/support). Support completes the connection setup with you.\n7. After setup, return to **Settings → Integrations**. Check for the source name with the **Connected** label in the linked-source list.\n\n## Fields and columns\n\n- **Source name:** identifies the source shown in the selection menu and, once linked, in the Integrations list.\n- **Add a source:** opens the source-selection dialog; it does not itself complete the connection.\n- **Contact us:** opens the support-contact action when that option is offered for the selected source.\n- **Connected:** labels a source in the linked-source list. It does not by itself confirm that particular records have been transferred.\n\n## Expected result\n\nYou have started setup with support and know where to check the linked source afterward. Once the source is linked, Integrations displays its name with the Connected label. Contacting support alone does not produce that label.\n\n## Limitations\n\nThis guide covers Optiply-side source selection and the support handoff only. It does not cover configuration inside Picqer Fulfilment, guarantee that the connector appears in every account's menu, or confirm when data will first arrive. The documented connector reference below is separate from connection setup and does not confirm your account configuration.\n\n## Errors and recovery\n\nIf Add a source is disabled, wait for the source lists to finish loading. If the connector is missing, the control is unavailable, or the expected linked source does not appear after setup, [contact support](/support). Tell support which connector you want to connect or check.\n\n## Documented connector details\n\nThe documented Picqer Fulfilment integration distinguishes scoped and admin API keys. Their access differs, which affects how supplier data is handled.\n\n### Scoped key\n\nA scoped key is limited to one fulfilment customer's objects and cannot read supplier objects from Picqer Fulfilment.\n\nThe documented integration has two supplier-handling modes:\n\n- With supplier-name mapping enabled, an incoming buy order can create an Optiply supplier from the order's `supplier_name`.\n- With that mapping disabled, incoming buy orders use the unknown supplier.\n\nDo not assume which mode is enabled for your account.\n\n### Admin key\n\nAn admin key has broader access across the Picqer Fulfilment organisation, including supplier objects. The documented admin-key mapping reads those supplier objects and updates them in Optiply when they change in Picqer Fulfilment.\n\n### Before changing key type\n\nChanging between scoped and admin keys changes the required data and configuration. Contact Optiply Support before changing key type, without including the API key itself.\n\nThis reference explains documented data scope. It does not confirm your key permissions, connection status or successful order upload. See [Picqer Fulfilment warehouse data scope](/article/picqer-fulfilment-set-up-and-connection) for the separate warehouse-selection reference.\n\n## Data mapping guide\n\nAsk [Optiply Support](/support) which mapping guide applies to the selected source before comparing fields or planning the transition."}