> ## Documentation Index
> Fetch the complete documentation index at: https://sendcloud.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update certain parts of an integration

> Update the shop name, shop URL, service point settings, webhook settings, and feedback type of an integration.

You can update certain parts of an integration with this endpoint:

* Update the shop name of an integration
* Update the shop URL of an integration
* Enable service points and select the appropriate service point carriers
* Enable webhooks and set the webhook URL
* Change the type of feedback you would like the integration to follow


## OpenAPI

````yaml /.openapi/v3/integrations/openapi.yaml patch /integrations/{id}
openapi: 3.1.0
info:
  title: Integrations
  version: 3.0.0
  contact:
    name: Sendcloud API Support
    email: contact@sendcloud.com
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  description: >-
    The Integrations API lets you manage some aspects of your integrations, and
    set and retrieve available shop order statuses.
servers:
  - url: https://panel.sendcloud.sc/api/v3
    description: Sendcloud Production
security: []
tags:
  - name: Integrations
    description: IntegrationsAPI
  - name: Exception logs
    description: Integration exception logs API
paths:
  /integrations/{id}:
    parameters:
      - schema:
          type: integer
          minimum: 1
        name: id
        in: path
        required: true
        description: Filtering on the Sendcloud integration ID
    patch:
      tags:
        - Integrations
      summary: Update certain parts of an integration
      description: >-
        Update the shop name, shop URL, service point settings, webhook
        settings, and feedback type of an integration.
      operationId: sc-public-v3-integrations-patch-update_integration
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/integration-model'
            examples:
              UpdatingShopName:
                summary: Update the shop name on your integration
                description: Update the shop name on your integration.
                value:
                  shop_name: My Webshop
              EnableServicePointsIntegration:
                summary: Update an integration to enable service points.
                description: Update an integration to enable service points.
                value:
                  service_point_enabled: true
                  service_point_carriers:
                    - ups
                    - dhl
              EnableWebhooksForAnIntegration:
                summary: Update an integration to enable webhook feedback.
                description: >
                  Update an integration to enable Sendcloud to call your webhook
                  to provide parcel status feedback.
                value:
                  webhook_active: true
                  webhook_url: https://mywebshop.com/feedback
              UpdateFeedbackType:
                summary: Update type of feedback an integration will use.
                description: |
                  Update type of feedback an integration will use.
                value:
                  feedback_type: none
      responses:
        '204':
          description: No content
        '400':
          description: Webhook URL required when enable webhook is set to `true`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
              examples:
                WebhookDoesNotExist:
                  summary: Webhook url missing
                  value:
                    errors:
                      - status: '400'
                        code: invalid
                        title: Invalid
                        detail: >-
                          Webhook URL required when enable webhook is set to
                          true
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errors'
              examples:
                IntegrationDoesNotExist:
                  summary: Integration does not exist
                  value:
                    errors:
                      - status: 404
                        code: not_found
                        title: Not Found
                        detail: >-
                          The Integration could not be found with the search
                          criteria given
      security:
        - HTTPBasicAuth: []
components:
  schemas:
    integration-model:
      title: Integration Object
      type: object
      description: Integration object.
      properties:
        shop_name:
          type: string
          title: Shop Name
          maxLength: 250
          minLength: 1
          description: Name of the shop.
          example: My Shop Integration
        shop_url:
          type: string
          title: Shop url
          description: URL of the shop the integration connects to.
          format: uri
          minLength: 1
          example: https://www.my-shop-integration.com/
        service_point_enabled:
          type: boolean
          title: Service point enabled
          description: Flag indicating if delivery to service points is enabled.
          example: false
        service_point_carriers:
          type: array
          title: Service point carriers
          description: >-
            List of carriers available for the service point picker. If service
            point delivery is enabled, make sure to provide at least one
            carrier.
          items:
            type: string
            example: ups
          example:
            - ups
            - dhl
        webhook_active:
          type: boolean
          title: Webhook active
          description: Flag indicating if parcel updates should be sent via the webhook.
          example: false
        webhook_url:
          type:
            - string
            - 'null'
          title: Webhook url
          format: uri
          description: >-
            URL for sending updates on a parcel. A value for `webhook_url` is
            required if `webhook_active` is set to `true`.
          minLength: 1
          example: https://my-shop-integration.integrator/api/webhooks/sendcloud
        feedback_type:
          type: string
          title: Feedback Type
          enum:
            - eager
            - delayed
            - none
          description: >-
            Define how your shop status feedback should be sent into your
            system. 

            Note that this will not apply to Prestashop V2 as the custom status
            mapping will define this.  

            Use the following states:
               - eager: Change the parcels’ status to “sent” once the label is created.
               - delayed: Change the parcels’ status to “sent” once the carrier scans the label.
               - none: Don’t send any feedback.
          minLength: 1
    errors:
      title: Errors
      type: object
      description: A standardized format for errors in JSON:API responses.
      properties:
        errors:
          type:
            - array
            - object
          items:
            type: object
            allOf:
              - $ref: '#/components/schemas/ErrorObject'
            required:
              - status
              - code
              - detail
    ErrorObject:
      title: Error
      type: object
      description: Error in a JSON:API error format
      properties:
        id:
          type: string
          description: A unique identifier for the error.
        links:
          type: object
          description: >-
            A set of hyperlinks that provide additional information about the
            error.
          properties:
            about:
              type: string
              description: A URL that provides additional information about the error.
        status:
          type: string
          format: int32
          description: The HTTP status code of the error.
          minLength: 1
        code:
          type: string
          description: A unique error code for the error, in snake case format.
          minLength: 1
          enum:
            - unknown_field
            - invalid
            - forbidden
            - invalid_choice
            - min_value
            - 'null'
            - not_found
            - required
            - not_a_list
            - non_field_errors
            - authentication_failed
            - validation_error
            - parcel_announcement_error
        title:
          type: string
          description: A short, human-readable summary of the error.
          minLength: 1
        detail:
          type: string
          description: A human-readable explanation of the error.
          minLength: 1
        source:
          type: object
          description: >-
            An object that identifies the source of the error within the request
            payload.
          properties:
            pointer:
              type: string
              description: >-
                A `JSON` pointer to the location of the error within the request
                payload.
            parameter:
              type: string
              description: The name of the `query` parameter that caused the error.
            header:
              type: string
              description: The name of the `header` parameter that caused the error.
        meta:
          type: object
          description: Additional metadata about the error.
  securitySchemes:
    HTTPBasicAuth:
      type: http
      description: >-
        Basic Authentication using API key and secrets is currently the main
        authentication mechanism.
      scheme: basic

````