Skip to main content
An activity is one thing that happened with a contact: a note, an email, a call, a meeting, or a deal moving stage. Together they make the contact’s timeline. Your team logs them in the dashboard, Crevio’s agent logs them as it works, and you can log them through the API.

The object

When neither author_user nor author_agent is set on a stage change, Crevio made the move, for example when a quote was accepted. On any other kind, it means the team member who logged it has since been removed from the account.

Log an activity

Pass deal instead of contact to put it on a deal; the deal’s contact is filled in for you. Passing both with a contact that isn’t the deal’s answers 422. A meeting is the one kind that may have no contact, for a meeting you want on record before you know who it was with. It can also carry ends_at, which can’t be earlier than occurred_at.

Read the timeline

GET /activities lists activities newest first by occurred_at, and pages with starting_after like every other list.
The contact’s page in the dashboard also shows their orders, bookings, form submissions and tags on the same timeline. Those are not activities: read them from /orders, /bookings and /form_submissions.

Stage changes

Every time a deal moves, Crevio writes a stage activity with metadata.from and metadata.to. That happens however the deal moved: dragged on the board, POST /deals/{id}/move, a sent or accepted quote, or a removed stage. Stage changes are the record of what happened, so they can’t be logged, edited or deleted by hand. POST /activities with kind: "stage" answers 400. PATCH or DELETE on one answers 409 with code activity_immutable. Deleting the deal deletes its stage changes; its other activities stay on the contact’s timeline.

Change or delete an activity

PATCH /activities/{id} changes kind, body, occurred_at, ends_at, contact or deal. Send "" for contact or deal to clear it; only a meeting can be left without a contact. A timestamp that isn’t ISO 8601 answers 400 with code parameter_invalid. DELETE /activities/{id} removes it. When Crevio’s agent deletes one, it asks you first.

Webhooks

activity.created fires when a note, email, call or meeting is logged, activity.updated when one is edited, and activity.deleted when one is deleted. Each carries the activity with the contact and deal expanded. Stage changes send none of them: listen for deal.stage_changed instead.