Activities

An activity (path /activities/card-deliveries) is an operational log entry tracking events in the system. The current API surface focuses on digital membership card deliveries — each time a card is sent to a member, Communal logs an activity with delivery details.

Each card delivery activity records:

• Delivery status — success or failed
• Card formats — which formats were generated (Apple Wallet, Google Wallet, PDF)
• Recipient details — the user, their member ID, and the email addresses attempted
• Traceability — a request_hash linking the activity back to the originating API call
• Failure details — reason and error message when delivery fails

Activities are read-only. You query them for auditing, support, and monitoring — not for triggering actions.

Card delivery tracing

Every card send request generates a request_hash in the response. Use this hash to query the activities endpoint and trace the delivery — check whether it succeeded, which email addresses were attempted, and what card formats were generated.

After sending a card via /membership_cards/send, query /activities/card-deliveries with filter[request_hash] to trace the delivery.

API naming

Concept	API path	OpenAPI tag
Card delivery activity	/activities/card-deliveries	Activity

What's next

• Track card deliveries — monitor and audit membership card delivery attempts
• Send membership cards — trigger card deliveries