Create a Group
Creates a new group in your Fivetran account.
IMPORTANT: Groups and destinations are mapped 1:1 to each other. We do this mapping using the group's
idvalue that we automatically generate when you create a group, and the destination'sgroup_idvalue that you specify when you create a destination. This means that you must create a group in your Fivetran account before you can create a destination in it.
Request schema
Header parameters
Authorization
stringrequired
HTTP: basicAuth
HTTP AuthorizationScheme: basic
Accept
string
default:
example:
Request
name
string
The name of the group within your account.
example:
Http + 1.1
POST
https://api.fivetran.com/v1/groups
POST /v1/groups HTTP/1.1 Accept: application/json Authorization: BasicContent-Type: application/json Host: api.fivetran.com Content-Length: 26 { "name": "Group_Name" }
Responses
201
Successful response
Successful response schema
code
stringrequired
Response status code
example:
message
string
Response status text
example:
data
objectrequired
id
stringrequired
The unique identifier for the group within the Fivetran system.
example:
name
stringrequired
The name of the group within your account.
example:
created_at
stringrequired
The timestamp of when the group was created in your account.
format:
example:
{ "code": "Success", "message": "Operation performed.", "data": { "id": "group_id", "name": "Group_Name", "created_at": "2024-01-01T00:00:00Z" } }