> ## Documentation Index > Fetch the complete documentation index at: https://developers.redo.com/llms.txt > Use this file to discover all available pages before exploring further. # Set auto-selected shipping methods > Choose which shipping methods are shown first at checkout, in priority order. The first one available is pre-selected for the shopper, and methods not listed follow in their usual order. Send only the methods to put first, not every method. The list replaces the current one; send an empty list to turn auto-selection off. Read the current list from `autoSelectedShippingMethodIds` on the checkout experience. Requires the [`checkout_write`](/docs/api-reference/scopes) scope. ## OpenAPI ````yaml /api-schema/openapi.yaml put /stores/{storeId}/checkout-experiences/{checkoutExperienceId}/auto-selected-shipping-methods openapi: 3.1.0 info: contact: email: engineering-admin@getredo.com name: Redo Engineering description: | ## Endpoints Endpoints are authenticated using the Bearer authorization scheme, using the REDO_API_SECRET. ```txt GET /v2.2/resource HTTP/1.1 Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af Host: api.getredo.com ``` ## Webhooks Webhooks are authenticated using the Bearer authorization scheme, using a secret supplied by the subscriber. ```txt POST /events HTTP/1.1 Authorization: Bearer subscriberauth123 Host: subscriber.example.com ``` Webhook events are delivered in order for each individual subject (e.g. return). If the response is not a 2xx status code, the event will be retried multiple times before discarding it. title: Redo API version: 2.2.1 servers: - url: https://api.getredo.com/v2.2 security: [] tags: - description: >- Group several products under one product shoppers buy, so a returned bundle can be broken back into the products it contains. name: Bundles - name: Checkout Buttons - description: >- Manage the shipping methods shown at checkout. A checkout experience is a named group of shipping methods; the store's checkout tree decides which shoppers see which experience. name: Checkout Experiences - name: Coverage Info - name: Coverage Products - name: Custom Events - name: Customer Portal - name: Customer Subscriptions - name: Customers - name: Inbound Shipments - name: Inventory Items - name: Inventory Levels - name: Invoices - name: Merchant Admin - name: Orders - name: Products - name: Returns - description: >- Push orders into Redo from a commerce platform Redo does not support directly, so shoppers can return them. name: Returns Custom Integration - name: Storefront - name: Webhooks paths: /stores/{storeId}/checkout-experiences/{checkoutExperienceId}/auto-selected-shipping-methods: summary: Auto-Selected Shipping Methods parameters: - $ref: '#/components/parameters/store-id.param' - $ref: '#/components/parameters/checkout-experience-id.param' put: tags: - Checkout Experiences summary: Set auto-selected shipping methods description: > Choose which shipping methods are shown first at checkout, in priority order. The first one available is pre-selected for the shopper, and methods not listed follow in their usual order. Send only the methods to put first, not every method. The list replaces the current one; send an empty list to turn auto-selection off. Read the current list from `autoSelectedShippingMethodIds` on the checkout experience. Requires the [`checkout_write`](/docs/api-reference/scopes) scope. operationId: Checkout auto-selected shipping methods set requestBody: content: application/json: schema: $ref: >- #/components/schemas/checkout-auto-selected-shipping-methods-request.schema examples: preselect_one: summary: Show Express first and pre-select it value: shippingMethodIds: - 66b2f1c9e4b0a1d2c3f4a5c8 turn_off: summary: Turn auto-selection off value: shippingMethodIds: [] required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/checkout-experience-write-response.schema' examples: updated: summary: The updated experience's ID value: checkoutExperienceId: 66b2f1c9e4b0a1d2c3f4a5b6 description: Updated '400': content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' examples: foreign_method: summary: A shipping method from another experience value: type: com.getredo.api:checkout/invalid-request title: Invalid checkout configuration detail: >- Shipping method 66b2f1c9e4b0a1d2c3f4a5e9 is not part of this checkout experience. description: >- Invalid request body, a repeated shipping method, a shipping method that is not part of the experience, or a store configuration that cannot use auto-selection. Returned with type `com.getredo.api:checkout/invalid-request`. '404': content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' description: >- No checkout experience with this ID exists for the store. Returned with type `com.getredo.api:checkout/not-found`. default: content: application/problem+json: schema: $ref: '#/components/schemas/error.schema' description: Error security: - Bearer: [] components: parameters: store-id.param: description: Store ID in: path name: storeId required: true schema: example: 64e5a8a1af49a89df37e4ee7 type: string checkout-experience-id.param: description: Checkout experience ID. in: path name: checkoutExperienceId required: true schema: example: 66b2f1c9e4b0a1d2c3f4a5b6 type: string schemas: checkout-auto-selected-shipping-methods-request.schema: properties: shippingMethodIds: description: >- Shipping method IDs to show first, highest priority first; the first available is pre-selected. Replaces the current list. Send an empty list to turn auto-selection off. example: - 66b2f1c9e4b0a1d2c3f4a5c8 items: type: string type: array required: - shippingMethodIds title: Auto-selected shipping methods request type: object checkout-experience-write-response.schema: properties: checkoutExperienceId: description: >- The checkout experience that was written. Read it back with `GET /stores/{storeId}/checkout-experiences/{checkoutExperienceId}`. example: 66b2f1c9e4b0a1d2c3f4a5b6 type: string required: - checkoutExperienceId title: Checkout experience write result type: object error.schema: description: >- Problem details. See [RFC 7807 Section 3](https://datatracker.ietf.org/doc/html/rfc7807#section-3). properties: detail: description: Human-readable description of the problem. title: Detail type: string instance: description: A URI reference that identifies this problem. format: uri-reference type: string title: description: Human-readable summary of the problem type. title: Title type: string type: default: about:blank description: A URI reference that identifies the problem type. format: uri-reference type: string title: Problem details type: object securitySchemes: Bearer: scheme: bearer type: http ````