Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Regal Events API

Contact creation, update, and custom event tracking

Regal Events API is one of 8 APIs that Regal publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, a changelog, and 4 JSON Schemas.

This API exposes 1 operation across 1 path, and defines 7 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.regal.ai/v1.

1 operations 1 paths 7 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Server
https://api.regal.ai/v1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Regal Events API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Events 1

Contact creation, update, and custom event tracking

POST
/events
Post Custom Event
postCustomEvent body → 200400401429

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are CustomEvent (6 properties), ContactTraits (5 properties), PhoneTrait (5 properties), Address (5 properties). Each schema is shown below with its type and property counts.

CustomEvent
object
6 properties 1 required
Address
object
5 properties
Error
object
2 properties
EmailTrait
object
4 properties 1 required
OptInState
object
3 properties
PhoneTrait
object
5 properties 1 required
ContactTraits
object
Identifiers and attributes describing the contact.
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

regal-ai-events-api-openapi.yml Raw ↑

Other APIs Regal publishes across the network.

Regal Reporting Webhooks
Regal Branded Phone Numbers API
Regal Business Profiles API
Regal Campaigns API
Regal Dispositions API
Regal Messages API
Regal Phone Numbers API