Skip to content

Audit log

The audit log records who changed what: sign-ins and 2FA, API key creation, rotation and revocation, role changes, phone pairing, webhook, blacklist and preference changes, campaign actions, contact exports and erasures, and Verify blocks. Entries can’t be edited or deleted. In the portal it is Audit log (walkthrough).

Field Type Description
id string aud_…
actorType string Who did it: user, api_key, device, admin or platform_staff (SMSFabric staff), or system.
actorId string or null The user, key or phone id.
actor object { type, id, name, email }: the actor ready to show. name is the user’s, key’s or phone’s name; email is set for users only. Staff and system have no name, and a deleted actor has name: null.
action string Such as apikey.created, campaign.started, contacts.exported.
targetType, targetId string or null What it was done to.
ip string or null The caller’s IP.
userAgent string or null
requestId string or null Matches requestId in error responses and support tickets.
metadata object or null Details. Never contains phone numbers, message bodies or secrets.
createdAt string
GET/v1/auditaudit:read

Newest first, paginated.

Query Type Description
action string Only this action.
q string Part of the action, or of the actor’s name or email, an API key’s name or a phone’s name. Up to 120 characters. staff finds SMSFabric staff.
limit integer 1 to 200, default 50.
cursor string nextCursor from the previous page.
Terminal window
curl "https://api.smsfabric.com/v1/audit?q=apikey" \
-H "X-Api-Key: $SMSFABRIC_API_KEY"
{
"data": [
{
"id": "aud_r2u5x8a1d4g7j0m3p6s9v2y5",
"actorType": "user",
"actorId": "usr_o9r2u5x8a1d4g7j0m3p6s9v2",
"actor": { "type": "user", "id": "usr_o9r2u5x8a1d4g7j0m3p6s9v2", "name": "Mona Adel", "email": "mona@example.com" },
"action": "apikey.created",
"targetType": "api_key",
"targetId": "key_l6o9r2u5x8a1d4g7j0m3p6s9",
"ip": "203.0.113.24",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6)",
"requestId": "req_w9z2c5f8i1l4o7r0u3x6a9d2",
"metadata": null,
"createdAt": "2026-11-19T13:00:00.000Z"
}
],
"nextCursor": null
}