---
title: "Create a data source or third-party service"
method: POST
path: "/groups/{groupId}/apps/{appId}/services"
tags: ["services"]
---

# Create a data source or third-party service

`POST /groups/{groupId}/apps/{appId}/services`

Create a [data source](https://www.mongodb.com/docs/atlas/app-services/mongodb/) or [third-party
service [Deprecated]](https://www.mongodb.com/docs/atlas/app-services/reference/services/).

## Request body

- union
  - AtlasClusterServiceConstructor
    - `name` string — The service name.
    - `type` string — The type of service.
  - AtlasFederatedInstance
    - `_id` string
    - `name` 'mongodb-datafederation', required
    - `type` 'datalake', required
    - `config` object, required
      - `dataLakeName` string, required — The service name used to refer to the Federated database instance within this Atlas app. The name may be at most 64 characters long and must only contain ASCII letters, numbers, underscores, and hyphens.
  - ThirdPartyServiceConstructor
    - `name` string — The service name.
    - `type` 'aws' | 'twilio' | 'github' | 'gcm' | 'http' — The type of service.
    - `incoming_webhooks` IncomingWebhook[]
      - `name` string, required
      - `function_source` string, required
      - `respond_result` boolean, required
      - `options` object
        - `secret` string
        - `secretAsQueryParam` boolean
    - `version` integer

## Response `201`

Successfully created.

- union
  - AtlasCluster
    - `_id` string — The cluster's unique ID.
    - `name` string — The service name.
    - `type` string — The type of service.
  - AtlasFederatedInstance
    - `_id` string
    - `name` 'mongodb-datafederation', required
    - `type` 'datalake', required
    - `config` object, required
      - `dataLakeName` string, required — The service name used to refer to the Federated database instance within this Atlas app. The name may be at most 64 characters long and must only contain ASCII letters, numbers, underscores, and hyphens.
  - ThirdPartyService — **THIRD-PARTY SERVICES ARE DEPRECATED** See [Third-Party Services](https://www.mongodb.com/docs/atlas/app-services/reference/services/) for more information.
    - `_id` string — A unique ID for the third-party service.
    - `name` string — The third-party service name.
    - `type` 'aws' | 'twilio' | 'github' | 'gcm' — The type of third party service.
    - `version` integer

## Other responses

- `409` — There is already a service with the given `name`.

---

[API](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api.md) · [All operations](https://skmtc.net/mongodb/apis/mongodb-atlas-app-services-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mongodb/mongodb-atlas-app-services-admin-api/versions/1365ab72bc03/schema)