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).
The entry object
Section titled “The entry object”| 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 |
List entries
Section titled “List entries”GET
/v1/auditaudit:readNewest 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. |
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}