Audiences

Audience segments for campaigns

List audiences

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience

Get all audiences with pagination. Searchable: name, description.

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Query parameters

pageintegerOptionalDefault: 1

limitinteger · max: 100OptionalDefault: 20

searchstringOptional

sortBystring · enumOptionalPossible values:

sortOrderstring · enumOptionalDefault: descPossible values:

Responses

200

Paginated list of audiences

application/json

401

Unauthorized

get

/audience

HTTPcURLJavaScriptPython

GET /audience HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "createdAt": "2025-12-19T15:55:16.031Z",
      "updatedAt": "2025-12-19T15:55:16.031Z",
      "deletedAt": "2025-12-19T15:55:16.031Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

Create audience

post

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Body

application/json

namestringRequired

descriptionstringOptional

Responses

201

Audience created

application/json

400

Invalid input

401

Unauthorized

post

/audience

HTTPcURLJavaScriptPython

POST /audience HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "createdAt": "2025-12-19T15:55:16.031Z",
  "updatedAt": "2025-12-19T15:55:16.031Z",
  "deletedAt": "2025-12-19T15:55:16.031Z"
}

Get audience by ID

get

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience/{id}

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audience details

application/json

401

Unauthorized

404

Audience not found

get

/audience/{id}

HTTPcURLJavaScriptPython

GET /audience/{id} HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "createdAt": "2025-12-19T15:55:16.031Z",
  "updatedAt": "2025-12-19T15:55:16.031Z",
  "deletedAt": "2025-12-19T15:55:16.031Z"
}

Update audience

put

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience/{id}

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Body

application/json

namestringOptional

descriptionstringOptional

Responses

200

Audience updated

application/json

401

Unauthorized

404

Audience not found

put

/audience/{id}

HTTPcURLJavaScriptPython

PUT /audience/{id} HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "createdAt": "2025-12-19T15:55:16.031Z",
  "updatedAt": "2025-12-19T15:55:16.031Z",
  "deletedAt": "2025-12-19T15:55:16.031Z"
}

Delete audience

delete

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience/{id}

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Responses

200

Audience deleted

application/json

401

Unauthorized

404

Audience not found

delete

/audience/{id}

HTTPcURLJavaScriptPython

DELETE /audience/{id} HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "createdAt": "2025-12-19T15:55:16.031Z",
  "updatedAt": "2025-12-19T15:55:16.031Z",
  "deletedAt": "2025-12-19T15:55:16.031Z"
}

Add contacts to audience

post

https://api.gomobile.iohttps://staging-api.gomobile.iohttp://localhost:3000

/audience/{id}/add-contacts

Authorizations

BearerAuth

AuthorizationstringRequired

API key provided by GoMobile team. Request yours at https://docs.google.com/forms/d/1F6_7OIDNq8_lWgKPyP-DudF3dvBTl31X4dqVf5St2zE

Path parameters

idstring · uuidRequired

Body

application/json

contactsstring · uuid[]Required

Responses

200

Contacts added

application/json

Responsestring · uuid[]

401

Unauthorized

404

Audience not found

post

/audience/{id}/add-contacts

HTTPcURLJavaScriptPython

POST /audience/{id}/add-contacts HTTP/1.1
Host: api.gomobile.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "contacts": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

[
  "123e4567-e89b-12d3-a456-426614174000"
]