Email a CSV of contacts

POST/meet-logs/export

Send a download link for a CSV of your contacts (one row per person) to the authenticated user's email address. The link is valid for 24 hours. Your own CSV also contains the cards you exchanged with communities (told apart by the trailing Type column). With asCommunityId, the CSV lists the people that community exchanged with, including a Newsletter column.

Auth	Login required

Request body

asCommunityIdstring | nulloptional

When given, exports the people that community exchanged with (approved admins only). When omitted, exports the cards you exchanged.

lang'ja' | 'en'optional

Language of the email and CSV headers. Defaults to the user's language.

timezonestringoptional

IANA time zone for dates in the CSV. Defaults to Asia/Tokyo.

Notes

Up to 3 times per hour (429, errorCode 40214, beyond that). Returns 400 (errorCode 40213) when there is no one to export.

The CSV download URL arrives only by email and cannot be called with an access token. Shared email addresses are included only when the request came from an official 4S app.

Returns 403 (errorCode 40208) when you are not an admin of the asCommunityId community. The hourly limit (3 per hour) for a community's CSV is counted separately from your own CSV. The link works only while the requester is still an admin at download time.

The Newsletter column in a community's CSV is TRUE or FALSE. A subscriber's email address is included even if they turned off email sharing. 4S does not send newsletters.

Response

Field	Type	Description
`count`	number	Number of people in the CSV.
`expiresAt`	string	Link expiry (ISO 8601).

Request

curl https://api.4s.link/meet-logs/export \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "lang": "ja",
  "timezone": "Asia/Tokyo"
}'

Example response

{
  "count": 4,
  "expiresAt": "2026-07-11T06:40:00.000Z"
}