Everyday | API DocumentationEveryday | API Documentation
  • Pricing
  • Documentation
  • API Reference
Information
Organizations
    List available organizationsget
Profiles
    List profilesgetCreate profilepostRetrieve profilegetDelete profiledeleteUpdate profilepatchList a profile's eventsgetCreate event for a profilepostList a profile's seriesgetCreate series for a profilepostList followers of a profileget
Events
    List a profile's eventsgetCreate event for a profilepostList eventsgetCreate eventpostRetrieve eventgetDelete eventdeleteUpdate eventpatchCancel eventpostReschedule eventpostList RSVPsgetCreate RSVPpostDelete RSVPdeleteUpdate RSVPpatchRSVP statisticsgetGet RSVP settingsgetUpdate RSVP settingspatchList events in a seriesgetAdd event to seriespostRemove event from seriesdelete
RSVPs
    List RSVPsgetCreate RSVPpostDelete RSVPdeleteUpdate RSVPpatchRSVP statisticsgetGet RSVP settingsgetUpdate RSVP settingspatch
Series
    List a profile's seriesgetCreate series for a profilepostList seriesgetRetrieve seriesgetDelete seriesdeleteUpdate seriespatchPreview series deletiongetList events in a seriesgetAdd event to seriespostRemove event from seriesdelete
Calendars
    List calendarsgetRetrieve calendargetList calendar eventsgetCreate calendar eventpostDelete calendar eventdeleteUpdate calendar eventpatchList connected external calendarsgetRead your agendaget
Subscriptions
    List subscriptionsgetCreate subscriptionpostRetrieve subscriptiongetDelete subscriptiondeleteUpdate subscriptionpatch
Follows
    List followers of a profilegetList followsgetCreate followpostDelete followdelete
Search
    Search across events, profiles, and seriesget
MCP
    MCP Server (consumer / OAuth)postMCP Server (developer / API key)post
Schemas
powered by Zuplo
Everyday Public API
Everyday Public API

Follows

Lightweight follow relationships between users and profiles, series, or events.


List followers of a profile

GET
https://api.every.day
/v1/profiles/{profile_id}/followers

Returns users following the specified profile. Only returned if the profile is public, or if the authenticated user owns the profile.

List followers of a profile › path Parameters

profile_id
​string · pattern: ^prf_[0-9a-fA-F]{32}… · required

Prefixed unique identifier of the profile (e.g., prf_8f3ab21e49c44c8baf7b5e4a1b2c3d4e).

List followers of a profile › query Parameters

cursor
​string

Opaque cursor returned from a previous list response.

limit
​integer · min: 1 · max: 100

Maximum number of items to return per page. Range 1-100, default 20.

Default: 20

List followers of a profile › Responses

Page

​object[] · required
has_more
​boolean · required
next_cursor
​string | null · required
GET/v1/profiles/{profile_id}/followers
curl --request GET \ --url https://api.every.day/v1/profiles/:profile_id/followers
shell
Example Responses
No example specified for this content type
application/json

List follows

GET
https://api.every.day
/v1/follows

Returns follows owned by the authenticated user (i.e., who the caller is following).

List follows › query Parameters

cursor
​string

Opaque cursor returned from a previous list response.

limit
​integer · min: 1 · max: 100

Maximum number of items to return per page. Range 1-100, default 20.

Default: 20

List follows › Responses

Page

​object[] · required
has_more
​boolean · required
next_cursor
​string | null · required
GET/v1/follows
curl --request GET \ --url https://api.every.day/v1/follows
shell
Example Responses
No example specified for this content type
application/json

Create follow

POST
https://api.every.day
/v1/follows

Creates a follow relationship from the authenticated user to a profile, series, or event. Duplicate follows are not created; calling again returns the existing follow.

Create follow › Headers

Idempotency-Key
​string · minLength: 8 · maxLength: 255

A client-generated identifier (UUIDv4 recommended; 8–255 chars, alphanumeric/underscore/hyphen) for the request. The header is validated and logged, but server-side deduplication is not enforced: resubmitting a create with the same key produces a second resource. Treat creates as non-idempotent and design retries accordingly. Deduplication is planned for a future API version.

Create follow › Request Body

following_type
​string · enum · required
Enum values:
profile
series
event
target_id
​string · pattern: ^(prf|ser|evt)_[0-9a… · required

Prefixed ID of the target resource.

Create follow › Responses

Created

id
​string · pattern: ^fol_[0-9a-fA-F]{32}…
following_type
​string · enum
Enum values:
profile
series
event
target_id
​string | null · pattern: ^(prf|ser|evt)_[0-9a…

Prefixed identifier of the followed profile, series, or event. Null only when the original target is no longer visible.

created_at
​string | null · date-time
POST/v1/follows
curl --request POST \ --url https://api.every.day/v1/follows \ --header 'Content-Type: application/json' \ --data ' { "following_type": "profile", "target_id": "target_id" } '
shell
Example Request Body
{ "following_type": "profile", "target_id": "target_id" }
json
Example Responses
No example specified for this content type
application/json

Delete follow

DELETE
https://api.every.day
/v1/follows/{follow_id}

Unfollows. Idempotent — deleting an already-deleted follow is a no-op.

Delete follow › path Parameters

follow_id
​string · pattern: ^fol_[0-9a-fA-F]{32}… · required

Prefixed unique identifier of the follow (e.g., fol_8f3ab21e49c44c8baf7b5e4a1b2c3d4e).

Delete follow › Responses

Deleted

No data returned
DELETE/v1/follows/{follow_id}
curl --request DELETE \ --url https://api.every.day/v1/follows/:follow_id
shell
Example Responses
No example specified for this content type

SubscriptionsSearch