Everyday | API DocumentationEveryday | API Documentation
  • Pricing
  • Documentation
  • API Reference
Information
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 eventpatch
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 · 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 · required

Prefixed ID of the target resource.

Create follow › Responses

Created

id
​string
following_type
​string
created_at
​string · 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 · 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