Mobly REST API

List events

get

List events for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Events list.

application/json

statusintegerRequiredExample: 200

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests

application/json

500

Internal server error

application/json

get/events

HTTPcURLJavaScriptPython

GET /api/v0/events HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "events": [
      {
        "id": 1,
        "name": "text",
        "type": "CONFERENCE",
        "registrationEnabled": true,
        "createdAt": "2026-07-16T21:13:06.799Z",
        "startDate": "2026-07-16",
        "endDate": "2026-07-16",
        "location": {
          "streetAddress": "text",
          "city": "text",
          "state": "text",
          "zip": "text",
          "country": "text",
          "latitude": "text",
          "longitude": "text",
          "timeZone": "text"
        },
        "tagGroups": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      }
    ],
    "total": 1
  }
}

Create event

post

Create an event for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

eventNamestringRequired

eventTypestring · enumRequired

Event type classification.

Possible values:

startDatestring · dateRequired

endDatestring · dateRequired

createdByEmailstring · emailRequired

registrationEnabledbooleanOptional

Responses

200

Created event.

application/json

statusintegerRequiredExample: 200

400

Bad request

application/json

401

Unauthorized

application/json

post/events

HTTPcURLJavaScriptPython

POST /api/v0/events HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "eventName": "text",
  "eventType": "CONFERENCE",
  "startDate": "2026-07-16",
  "endDate": "2026-07-16",
  "createdByEmail": "[e-mail]",
  "registrationEnabled": true
}

{
  "status": 200,
  "results": {
    "id": 1,
    "name": "text",
    "type": "CONFERENCE",
    "registrationEnabled": true,
    "createdAt": "2026-07-16T21:13:06.799Z",
    "startDate": "2026-07-16",
    "endDate": "2026-07-16",
    "location": {
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text",
      "latitude": "text",
      "longitude": "text",
      "timeZone": "text"
    },
    "tagGroups": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

Get event

get

Fetch a single event by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Responses

200

Event.

application/json

statusintegerRequiredExample: 200

404

Event not found

application/json

get/events/{eventId}

HTTPcURLJavaScriptPython

GET /api/v0/events/{eventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "id": 1,
    "name": "text",
    "type": "CONFERENCE",
    "registrationEnabled": true,
    "createdAt": "2026-07-16T21:13:06.799Z",
    "startDate": "2026-07-16",
    "endDate": "2026-07-16",
    "location": {
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text",
      "latitude": "text",
      "longitude": "text",
      "timeZone": "text"
    },
    "tagGroups": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

Update event

put

Update the full event record for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Body

application/json

eventNamestringRequired

eventTypestring · enumRequired

Event type classification.

Possible values:

startDatestring · dateRequired

endDatestring · dateRequired

registrationEnabledbooleanOptional

Responses

200

Updated event.

application/json

statusintegerRequiredExample: 200

404

Event not found

application/json

put/events/{eventId}

HTTPcURLJavaScriptPython

PUT /api/v0/events/{eventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "eventName": "text",
  "eventType": "CONFERENCE",
  "startDate": "2026-07-16",
  "endDate": "2026-07-16",
  "registrationEnabled": true
}

{
  "status": 200,
  "results": {
    "id": 1,
    "name": "text",
    "type": "CONFERENCE",
    "registrationEnabled": true,
    "createdAt": "2026-07-16T21:13:06.799Z",
    "startDate": "2026-07-16",
    "endDate": "2026-07-16",
    "location": {
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text",
      "latitude": "text",
      "longitude": "text",
      "timeZone": "text"
    },
    "tagGroups": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}

Delete event

delete

Delete an event for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Responses

200

Event deleted.

application/json

statusintegerRequiredExample: 200

resultsobjectRequired

404

Event not found

application/json

delete/events/{eventId}

HTTPcURLJavaScriptPython

DELETE /api/v0/events/{eventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {}
}

List event leads

get

Retrieve the leads associated with a specific event, including registration and check-in status.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Event leads list.

application/json

statusintegerRequiredExample: 200

get/events/{eventId}/leads

HTTPcURLJavaScriptPython

GET /api/v0/events/{eventId}/leads HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Event leads list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "eventLeads": [
      {
        "leadId": "123e4567-e89b-12d3-a456-426614174000",
        "registered": true,
        "checkedIn": true
      }
    ],
    "total": 1
  }
}

Add or update event leads

put

Associate existing leads with an event and optionally update their registered and checkedIn status.

• Creates association if missing.

• Updates flags if association exists.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Body

application/json

Responses

200

Updated event lead associations.

application/json

statusintegerRequiredExample: 200

put/events/{eventId}/leads

HTTPcURLJavaScriptPython

PUT /api/v0/events/{eventId}/leads HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "eventLeads": [
    {
      "leadId": "123e4567-e89b-12d3-a456-426614174000",
      "registered": true,
      "checkedIn": true
    }
  ]
}

200

Updated event lead associations.

{
  "status": 200,
  "results": {
    "eventLeads": [
      {
        "leadId": "123e4567-e89b-12d3-a456-426614174000",
        "registered": true,
        "checkedIn": true
      }
    ]
  }
}

Remove lead from event

delete

Delete a lead's association with an event for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

leadIdstringRequired

Lead ID

Responses

200

Association removed.

application/json

statusintegerRequiredExample: 200

resultsobjectRequired

delete/events/{eventId}/leads/{leadId}

HTTPcURLJavaScriptPython

DELETE /api/v0/events/{eventId}/leads/{leadId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Association removed.

{
  "status": 200,
  "results": {}
}

List event users

get

Retrieve the users assigned to a specific event for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

eventIdintegerRequired

Event ID

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Event users list.

application/json

statusintegerRequiredExample: 200

get/events/{eventId}/users

HTTPcURLJavaScriptPython

GET /api/v0/events/{eventId}/users HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Event users list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "users": [
      {
        "id": 1,
        "email": "text",
        "firstName": "text",
        "lastName": "text"
      }
    ],
    "total": 1
  }
}

List leads

get

List leads for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Leads list.

application/json

statusintegerRequiredExample: 200

get/leads

HTTPcURLJavaScriptPython

GET /api/v0/leads HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Leads list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "leads": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "isEnriched": true,
        "firstName": "text",
        "lastName": "text",
        "email": "[e-mail]",
        "description": "text",
        "linkedin": "text",
        "facebook": "text",
        "twitter": "text",
        "jobTitle": "text",
        "address": "text",
        "phoneNumbers": {
          "leadProvided": [
            {
              "number": "text",
              "type": "MOBILE",
              "preferred": true
            }
          ],
          "moblyProvided": [
            {
              "number": "text",
              "type": "MOBILE",
              "preferred": true
            }
          ]
        },
        "company": {
          "name": "text",
          "industry": "text",
          "linkedin": "text",
          "streetAddress": "text",
          "city": "text",
          "state": "text",
          "zip": "text",
          "country": "text"
        },
        "numberOfScans": 1,
        "lastScannedBy": "[e-mail]",
        "activations": [
          {
            "activationId": "123e4567-e89b-12d3-a456-426614174000",
            "checkedIn": true,
            "registered": true
          }
        ],
        "tags": [
          {
            "tagOptionId": "123e4567-e89b-12d3-a456-426614174000",
            "value": "text"
          }
        ],
        "leadActivityEvents": [
          "123e4567-e89b-12d3-a456-426614174000"
        ],
        "remoteIds": [
          {
            "id": "text",
            "integrationType": null
          }
        ]
      }
    ],
    "total": 1
  }
}

Create lead

post

Create a lead for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

createdByEmailstring · emailRequired

firstNamestringRequired

lastNamestringRequired

companyNamestringRequired

emailstring · emailOptional

Responses

200

Created lead.

application/json

statusintegerRequiredExample: 200

post/leads

HTTPcURLJavaScriptPython

POST /api/v0/leads HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 186

{
  "createdByEmail": "[e-mail]",
  "firstName": "text",
  "lastName": "text",
  "companyName": "text",
  "email": "[e-mail]",
  "phoneNumbers": [
    {
      "number": "text",
      "type": "MOBILE",
      "preferred": true
    }
  ]
}

200

Created lead.

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-07-16T21:13:06.799Z",
    "isEnriched": true,
    "firstName": "text",
    "lastName": "text",
    "email": "[e-mail]",
    "description": "text",
    "linkedin": "text",
    "facebook": "text",
    "twitter": "text",
    "jobTitle": "text",
    "address": "text",
    "phoneNumbers": {
      "leadProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ],
      "moblyProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ]
    },
    "company": {
      "name": "text",
      "industry": "text",
      "linkedin": "text",
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text"
    },
    "numberOfScans": 1,
    "lastScannedBy": "[e-mail]",
    "activations": [
      {
        "activationId": "123e4567-e89b-12d3-a456-426614174000",
        "checkedIn": true,
        "registered": true
      }
    ],
    "tags": [
      {
        "tagOptionId": "123e4567-e89b-12d3-a456-426614174000",
        "value": "text"
      }
    ],
    "leadActivityEvents": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "remoteIds": [
      {
        "id": "text",
        "integrationType": null
      }
    ]
  }
}

Get lead

get

Fetch a single lead by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

leadIdstringRequired

Lead ID

Responses

200

Lead.

application/json

statusintegerRequiredExample: 200

404

Lead not found

application/json

get/leads/{leadId}

HTTPcURLJavaScriptPython

GET /api/v0/leads/{leadId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-07-16T21:13:06.799Z",
    "isEnriched": true,
    "firstName": "text",
    "lastName": "text",
    "email": "[e-mail]",
    "description": "text",
    "linkedin": "text",
    "facebook": "text",
    "twitter": "text",
    "jobTitle": "text",
    "address": "text",
    "phoneNumbers": {
      "leadProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ],
      "moblyProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ]
    },
    "company": {
      "name": "text",
      "industry": "text",
      "linkedin": "text",
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text"
    },
    "numberOfScans": 1,
    "lastScannedBy": "[e-mail]",
    "activations": [
      {
        "activationId": "123e4567-e89b-12d3-a456-426614174000",
        "checkedIn": true,
        "registered": true
      }
    ],
    "tags": [
      {
        "tagOptionId": "123e4567-e89b-12d3-a456-426614174000",
        "value": "text"
      }
    ],
    "leadActivityEvents": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "remoteIds": [
      {
        "id": "text",
        "integrationType": null
      }
    ]
  }
}

Delete lead

delete

Delete a lead for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

leadIdstringRequired

Lead ID

Responses

200

Lead deleted.

application/json

statusintegerRequiredExample: 200

resultsobjectRequired

delete/leads/{leadId}

HTTPcURLJavaScriptPython

DELETE /api/v0/leads/{leadId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Lead deleted.

{
  "status": 200,
  "results": {}
}

Patch lead

patch

Partially update a lead and its associated persona record.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

leadIdstringRequired

Lead ID

Body

application/json

firstNamestring · nullableOptional

lastNamestring · nullableOptional

emailstring · email · nullableOptional

addressstring · nullableOptional

linkedinstring · nullableOptional

facebookstring · nullableOptional

twitterstring · nullableOptional

profilePicturestring · nullableOptional

descriptionstring · nullableOptional

jobTitlestring · nullableOptional

Responses

200

Updated lead.

application/json

statusintegerRequiredExample: 200

patch/leads/{leadId}

HTTPcURLJavaScriptPython

PATCH /api/v0/leads/{leadId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 312

{
  "firstName": "text",
  "lastName": "text",
  "email": "[e-mail]",
  "address": "text",
  "linkedin": "text",
  "facebook": "text",
  "twitter": "text",
  "profilePicture": "text",
  "description": "text",
  "jobTitle": "text",
  "phoneNumbers": [
    {
      "number": "text",
      "type": "MOBILE",
      "preferred": true
    }
  ],
  "remoteId": {
    "id": "text",
    "integrationType": null
  }
}

200

Updated lead.

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-07-16T21:13:06.799Z",
    "isEnriched": true,
    "firstName": "text",
    "lastName": "text",
    "email": "[e-mail]",
    "description": "text",
    "linkedin": "text",
    "facebook": "text",
    "twitter": "text",
    "jobTitle": "text",
    "address": "text",
    "phoneNumbers": {
      "leadProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ],
      "moblyProvided": [
        {
          "number": "text",
          "type": "MOBILE",
          "preferred": true
        }
      ]
    },
    "company": {
      "name": "text",
      "industry": "text",
      "linkedin": "text",
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text"
    },
    "numberOfScans": 1,
    "lastScannedBy": "[e-mail]",
    "activations": [
      {
        "activationId": "123e4567-e89b-12d3-a456-426614174000",
        "checkedIn": true,
        "registered": true
      }
    ],
    "tags": [
      {
        "tagOptionId": "123e4567-e89b-12d3-a456-426614174000",
        "value": "text"
      }
    ],
    "leadActivityEvents": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "remoteIds": [
      {
        "id": "text",
        "integrationType": null
      }
    ]
  }
}

List lead activity events

get

List lead activity events for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

leadIdstringOptional

Filter by associated lead ID

eventTypestring · enumOptional

Lead activity event type.

Possible values:

Responses

200

Lead activity events list.

application/json

statusintegerRequiredExample: 200

get/leadActivityEvents

HTTPcURLJavaScriptPython

GET /api/v0/leadActivityEvents HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Lead activity events list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "leadActivityEvents": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "createdBy": "[e-mail]",
        "eventType": "NOTE",
        "eventNotes": "text",
        "associatedLead": "123e4567-e89b-12d3-a456-426614174000",
        "associatedCampaign": "123e4567-e89b-12d3-a456-426614174000",
        "associatedEvent": 1,
        "associatedActivation": "123e4567-e89b-12d3-a456-426614174000",
        "associatedTagOption": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "total": 1
  }
}

Get lead activity event

get

Fetch a single lead activity event by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

leadActivityEventIdstringRequired

Lead activity event ID

Responses

200

Lead activity event.

application/json

statusintegerRequiredExample: 200

404

Not found

application/json

get/leadActivityEvents/{leadActivityEventId}

HTTPcURLJavaScriptPython

GET /api/v0/leadActivityEvents/{leadActivityEventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-07-16T21:13:06.799Z",
    "createdBy": "[e-mail]",
    "eventType": "NOTE",
    "eventNotes": "text",
    "associatedLead": "123e4567-e89b-12d3-a456-426614174000",
    "associatedCampaign": "123e4567-e89b-12d3-a456-426614174000",
    "associatedEvent": 1,
    "associatedActivation": "123e4567-e89b-12d3-a456-426614174000",
    "associatedTagOption": "123e4567-e89b-12d3-a456-426614174000"
  }
}

List activations

get

List activations for the organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Activations list.

application/json

statusintegerRequiredExample: 200

get/activations

HTTPcURLJavaScriptPython

GET /api/v0/activations HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Activations list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "activations": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "eventId": 1,
        "name": "text",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "type": "CONFERENCE",
        "startDate": "2026-07-16",
        "endDate": "2026-07-16",
        "startTime": "09:00:00",
        "endTime": "12:00:00",
        "createdBy": "[e-mail]",
        "location": {
          "streetAddress": "text",
          "city": "text",
          "state": "text",
          "zip": "text",
          "country": "text",
          "latitude": "text",
          "longitude": "text",
          "timeZone": "text"
        },
        "users": [
          "[e-mail]"
        ],
        "numberOfScans": 1
      }
    ],
    "total": 1
  }
}

Get activation

get

Fetch a single activation by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

activationIdstringRequired

Activation ID

Responses

200

Activation.

application/json

statusintegerRequiredExample: 200

404

Not found

application/json

get/activations/{activationId}

HTTPcURLJavaScriptPython

GET /api/v0/activations/{activationId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "eventId": 1,
    "name": "text",
    "createdAt": "2026-07-16T21:13:06.799Z",
    "type": "CONFERENCE",
    "startDate": "2026-07-16",
    "endDate": "2026-07-16",
    "startTime": "09:00:00",
    "endTime": "12:00:00",
    "createdBy": "[e-mail]",
    "location": {
      "streetAddress": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "country": "text",
      "latitude": "text",
      "longitude": "text",
      "timeZone": "text"
    },
    "users": [
      "[e-mail]"
    ],
    "numberOfScans": 1
  }
}

List tag groups

get

List tag groups defined for the organization, including tag options.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

Responses

200

Tag groups list.

application/json

statusintegerRequiredExample: 200

get/tagGroups

HTTPcURLJavaScriptPython

GET /api/v0/tagGroups HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Tag groups list.

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "tagGroups": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "status": "ARCHIVED",
        "allowsMultipleSelection": true,
        "displayOrder": 1,
        "usageInstructions": "text",
        "required": true,
        "allEvents": true,
        "tagOptions": [
          {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "displayOrder": 1,
            "value": "text"
          }
        ]
      }
    ],
    "total": 1
  }
}

Get tag group

get

Fetch a single tag group by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

tagGroupIdstringRequired

Tag group ID

Responses

200

Tag group.

application/json

statusintegerRequiredExample: 200

404

Not found

application/json

get/tagGroups/{tagGroupId}

HTTPcURLJavaScriptPython

GET /api/v0/tagGroups/{tagGroupId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "status": "ARCHIVED",
    "allowsMultipleSelection": true,
    "displayOrder": 1,
    "usageInstructions": "text",
    "required": true,
    "allEvents": true,
    "tagOptions": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "displayOrder": 1,
        "value": "text"
      }
    ]
  }
}

List industry events

get

List industry events. Supports filtering by URL or full-text search.

• eventUrl — return only the event matching this exact URL

• q — full-text search across name, venueCity, venueState, venueCountry, description, keywords, industries, personas

If eventUrl is provided, q is ignored. If neither is provided, all industry events are returned (paginated).

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

limitinteger · max: 50OptionalDefault: 20

offsetintegerOptionalDefault: 0

eventUrlstringOptional

Filter by exact event URL

qstringOptional

Full-text search query

Responses

200

Industry events list.

application/json

statusintegerRequiredExample: 200

401

Unauthorized

application/json

get/industryEvents

HTTPcURLJavaScriptPython

GET /api/v0/industryEvents HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "pagination": {
    "limit": 1,
    "offset": 1
  },
  "results": {
    "industryEvents": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "updatedAt": "2026-07-16T21:13:06.799Z",
        "name": "text",
        "startDate": "2026-07-16T21:13:06.799Z",
        "endDate": "2026-07-16T21:13:06.799Z",
        "sourceType": "text",
        "sourceId": "text",
        "eventType": "text",
        "venueCity": "text",
        "venueState": "text",
        "venueCountry": "text",
        "venueName": "text",
        "venueFullAddress": "text",
        "venueCoordinates": "text",
        "numberOfAttendees": 1,
        "numberOfExhibitors": 1,
        "attendeeCost": "text",
        "boothCost": "text",
        "exhibitorIndustries": [
          "text"
        ],
        "attendeePersonas": [
          "text"
        ],
        "keywords": [
          "text"
        ],
        "website": "text",
        "description": "text",
        "eventUrl": "text",
        "isBookmarked": true
      }
    ],
    "total": 1
  }
}

Create industry event

post

Create an industry event with automatic deduplication:

1. If an event with the same eventUrl already exists, the existing record is returned (created: false).

2. If no URL match but name and startDate match, the event is still created but potentialDuplicates are returned.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

namestringRequired

startDatestring · date-time · nullableOptional

endDatestring · date-time · nullableOptional

sourceTypestring · nullableOptional

sourceIdstring · nullableOptional

eventTypestring · nullableOptional

venueCitystring · nullableOptional

venueStatestring · nullableOptional

venueCountrystring · nullableOptional

venueNamestring · nullableOptional

venueFullAddressstring · nullableOptional

venueCoordinatesstring · nullableOptional

numberOfAttendeesinteger · nullableOptional

numberOfExhibitorsinteger · nullableOptional

attendeeCoststring · nullableOptional

boothCoststring · nullableOptional

exhibitorIndustriesstring[] · nullableOptional

attendeePersonasstring[] · nullableOptional

keywordsstring[] · nullableOptional

websitestring · nullableOptional

descriptionstring · nullableOptional

eventUrlstring · nullableOptional

Responses

200

Created or existing industry event.

application/json

statusintegerRequiredExample: 200

400

Bad request

application/json

post/industryEvents

HTTPcURLJavaScriptPython

POST /api/v0/industryEvents HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 501

{
  "name": "text",
  "startDate": "2026-07-16T21:13:06.799Z",
  "endDate": "2026-07-16T21:13:06.799Z",
  "sourceType": "text",
  "sourceId": "text",
  "eventType": "text",
  "venueCity": "text",
  "venueState": "text",
  "venueCountry": "text",
  "venueName": "text",
  "venueFullAddress": "text",
  "venueCoordinates": "text",
  "numberOfAttendees": 1,
  "numberOfExhibitors": 1,
  "attendeeCost": "text",
  "boothCost": "text",
  "exhibitorIndustries": [
    "text"
  ],
  "attendeePersonas": [
    "text"
  ],
  "keywords": [
    "text"
  ],
  "website": "text",
  "description": "text",
  "eventUrl": "text"
}

{
  "status": 200,
  "results": {
    "industryEvent": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-07-16T21:13:06.799Z",
      "updatedAt": "2026-07-16T21:13:06.799Z",
      "name": "text",
      "startDate": "2026-07-16T21:13:06.799Z",
      "endDate": "2026-07-16T21:13:06.799Z",
      "sourceType": "text",
      "sourceId": "text",
      "eventType": "text",
      "venueCity": "text",
      "venueState": "text",
      "venueCountry": "text",
      "venueName": "text",
      "venueFullAddress": "text",
      "venueCoordinates": "text",
      "numberOfAttendees": 1,
      "numberOfExhibitors": 1,
      "attendeeCost": "text",
      "boothCost": "text",
      "exhibitorIndustries": [
        "text"
      ],
      "attendeePersonas": [
        "text"
      ],
      "keywords": [
        "text"
      ],
      "website": "text",
      "description": "text",
      "eventUrl": "text",
      "isBookmarked": true
    },
    "created": true,
    "potentialDuplicates": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "updatedAt": "2026-07-16T21:13:06.799Z",
        "name": "text",
        "startDate": "2026-07-16T21:13:06.799Z",
        "endDate": "2026-07-16T21:13:06.799Z",
        "sourceType": "text",
        "sourceId": "text",
        "eventType": "text",
        "venueCity": "text",
        "venueState": "text",
        "venueCountry": "text",
        "venueName": "text",
        "venueFullAddress": "text",
        "venueCoordinates": "text",
        "numberOfAttendees": 1,
        "numberOfExhibitors": 1,
        "attendeeCost": "text",
        "boothCost": "text",
        "exhibitorIndustries": [
          "text"
        ],
        "attendeePersonas": [
          "text"
        ],
        "keywords": [
          "text"
        ],
        "website": "text",
        "description": "text",
        "eventUrl": "text",
        "isBookmarked": true
      }
    ]
  }
}

List bookmarked industry events

get

List industry events bookmarked by the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Responses

200

Bookmarked industry events.

application/json

statusintegerOptionalExample: 200

get/industryEvents/bookmarks

HTTPcURLJavaScriptPython

GET /api/v0/industryEvents/bookmarks HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

200

Bookmarked industry events.

{
  "status": 200,
  "results": {
    "industryEvents": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "createdAt": "2026-07-16T21:13:06.799Z",
        "updatedAt": "2026-07-16T21:13:06.799Z",
        "name": "text",
        "startDate": "2026-07-16T21:13:06.799Z",
        "endDate": "2026-07-16T21:13:06.799Z",
        "sourceType": "text",
        "sourceId": "text",
        "eventType": "text",
        "venueCity": "text",
        "venueState": "text",
        "venueCountry": "text",
        "venueName": "text",
        "venueFullAddress": "text",
        "venueCoordinates": "text",
        "numberOfAttendees": 1,
        "numberOfExhibitors": 1,
        "attendeeCost": "text",
        "boothCost": "text",
        "exhibitorIndustries": [
          "text"
        ],
        "attendeePersonas": [
          "text"
        ],
        "keywords": [
          "text"
        ],
        "website": "text",
        "description": "text",
        "eventUrl": "text",
        "isBookmarked": true
      }
    ]
  }
}

Get industry event

get

Fetch a single industry event by ID. Includes isBookmarked for the authenticated organization.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

industryEventIdstring · uuidRequired

Industry event ID

Responses

200

Industry event.

application/json

statusintegerRequiredExample: 200

404

Not found

application/json

get/industryEvents/{industryEventId}

HTTPcURLJavaScriptPython

GET /api/v0/industryEvents/{industryEventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "industryEvent": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-07-16T21:13:06.799Z",
      "updatedAt": "2026-07-16T21:13:06.799Z",
      "name": "text",
      "startDate": "2026-07-16T21:13:06.799Z",
      "endDate": "2026-07-16T21:13:06.799Z",
      "sourceType": "text",
      "sourceId": "text",
      "eventType": "text",
      "venueCity": "text",
      "venueState": "text",
      "venueCountry": "text",
      "venueName": "text",
      "venueFullAddress": "text",
      "venueCoordinates": "text",
      "numberOfAttendees": 1,
      "numberOfExhibitors": 1,
      "attendeeCost": "text",
      "boothCost": "text",
      "exhibitorIndustries": [
        "text"
      ],
      "attendeePersonas": [
        "text"
      ],
      "keywords": [
        "text"
      ],
      "website": "text",
      "description": "text",
      "eventUrl": "text",
      "isBookmarked": true
    }
  }
}

Update industry event

put

Partially update an industry event. Only fields included in the body are modified.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

industryEventIdstring · uuidRequired

Industry event ID

Body

application/json

namestringOptional

startDatestring · date-time · nullableOptional

endDatestring · date-time · nullableOptional

sourceTypestring · nullableOptional

sourceIdstring · nullableOptional

eventTypestring · nullableOptional

venueCitystring · nullableOptional

venueStatestring · nullableOptional

venueCountrystring · nullableOptional

venueNamestring · nullableOptional

venueFullAddressstring · nullableOptional

venueCoordinatesstring · nullableOptional

numberOfAttendeesinteger · nullableOptional

numberOfExhibitorsinteger · nullableOptional

attendeeCoststring · nullableOptional

boothCoststring · nullableOptional

exhibitorIndustriesstring[] · nullableOptional

attendeePersonasstring[] · nullableOptional

keywordsstring[] · nullableOptional

websitestring · nullableOptional

descriptionstring · nullableOptional

eventUrlstring · nullableOptional

Responses

200

Updated industry event.

application/json

statusintegerRequiredExample: 200

404

Not found

application/json

put/industryEvents/{industryEventId}

HTTPcURLJavaScriptPython

PUT /api/v0/industryEvents/{industryEventId} HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 501

{
  "name": "text",
  "startDate": "2026-07-16T21:13:06.799Z",
  "endDate": "2026-07-16T21:13:06.799Z",
  "sourceType": "text",
  "sourceId": "text",
  "eventType": "text",
  "venueCity": "text",
  "venueState": "text",
  "venueCountry": "text",
  "venueName": "text",
  "venueFullAddress": "text",
  "venueCoordinates": "text",
  "numberOfAttendees": 1,
  "numberOfExhibitors": 1,
  "attendeeCost": "text",
  "boothCost": "text",
  "exhibitorIndustries": [
    "text"
  ],
  "attendeePersonas": [
    "text"
  ],
  "keywords": [
    "text"
  ],
  "website": "text",
  "description": "text",
  "eventUrl": "text"
}

{
  "status": 200,
  "results": {
    "industryEvent": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-07-16T21:13:06.799Z",
      "updatedAt": "2026-07-16T21:13:06.799Z",
      "name": "text",
      "startDate": "2026-07-16T21:13:06.799Z",
      "endDate": "2026-07-16T21:13:06.799Z",
      "sourceType": "text",
      "sourceId": "text",
      "eventType": "text",
      "venueCity": "text",
      "venueState": "text",
      "venueCountry": "text",
      "venueName": "text",
      "venueFullAddress": "text",
      "venueCoordinates": "text",
      "numberOfAttendees": 1,
      "numberOfExhibitors": 1,
      "attendeeCost": "text",
      "boothCost": "text",
      "exhibitorIndustries": [
        "text"
      ],
      "attendeePersonas": [
        "text"
      ],
      "keywords": [
        "text"
      ],
      "website": "text",
      "description": "text",
      "eventUrl": "text",
      "isBookmarked": true
    }
  }
}

Bookmark industry event

post

Add an industry event to the authenticated organization's bookmarks.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

industryEventIdstring · uuidRequired

Industry event ID

Responses

200

Bookmarked.

application/json

statusintegerOptionalExample: 200

404

Not found

application/json

post/industryEvents/{industryEventId}/bookmark

HTTPcURLJavaScriptPython

POST /api/v0/industryEvents/{industryEventId}/bookmark HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "success": true
  }
}

Unbookmark industry event

delete

Remove an industry event from the authenticated organization's bookmarks.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

industryEventIdstring · uuidRequired

Industry event ID

Responses

200

Unbookmarked.

application/json

statusintegerOptionalExample: 200

404

Not found

application/json

delete/industryEvents/{industryEventId}/bookmark

HTTPcURLJavaScriptPython

DELETE /api/v0/industryEvents/{industryEventId}/bookmark HTTP/1.1
Host: core-api.getmobly.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "status": 200,
  "results": {
    "success": true
  }
}