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

# Start sync(s)

> Starts the schedule of specified sync(s) for a given connection or all applicable connections if no connection is specified. Upon starting the schedule, the sync will execute immediately and then continue to run at the specified frequency. If the schedule was already started, this will have no effect.

<Info>
  Requires an API key with the `environment:syncs:execute` scope. [Learn more about API key scopes](/reference/backend/http-api/api-keys#scopes).
</Info>


## OpenAPI

````yaml POST /sync/start
openapi: 3.1.0
info:
  title: Nango API
  description: Nango API specs used to authorize & sync data with external APIs.
  version: 1.0.0
servers:
  - url: https://api.nango.dev
    description: Production server
  - url: http://localhost:3003
    description: Local server
security:
  - bearerAuth: []
externalDocs:
  url: https://nango.dev/docs/reference/backend/http-api/authentication
paths:
  /sync/start:
    post:
      summary: Start a sync
      description: >-
        Starts the schedule of specified sync(s) for a given connection or all
        applicable connections if no connection is specified. Upon starting the
        schedule, the sync will execute immediately and then continue to run at
        the specified frequency. If the schedule was already started, this will
        have no effect.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - provider_config_key
                - syncs
              properties:
                provider_config_key:
                  type: string
                  description: The ID of the integration that you established within Nango.
                connection_id:
                  type: string
                  description: >-
                    The ID of the connection. If omitted, the syncs will be
                    started for all relevant connections.
                syncs:
                  oneOf:
                    - type: array
                      description: >-
                        A list of sync names that you wish to start. If empty,
                        all syncs are triggered
                      items:
                        type: string
                        description: Sync name
                        example: github-issues
                    - type: array
                      description: >-
                        A list of sync object (with a name and variant
                        properties) that you wish to start.
                      items:
                        type: object
                        required:
                          - name
                        properties:
                          name:
                            type: string
                            description: The name of the sync
                          variant:
                            type: string
                            description: The variant name
                        example:
                          name: github-issues
                          variant: custom-variant
      responses:
        '200':
          description: Successfully started the sync
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                properties:
                  success:
                    type: boolean
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: The secret key from your Nango environment.

````