Application API Profile members email POST

October 15, 2026 at 9:35 AM

/members/self/email/authorization-code [POST]

Given a legacy email token, obtain a code that can be used with the Authorization Server - unprotected.

Parameters

Client credentials:

  • client_id (string) [REQUIRED] - the pre-registered UUID that identifies your client app,
  • client_secret (string) [REQUIRED] - the base64 “secret” provided by World Singles when you registered your client app,
  • platform (string) [optional] - one of "app_android", "app_ios", or "web"; identifies the host platform for the client application which may be used in logging internally to help us understand behavior across platforms.

Token:

  • suk (string) [REQUIRED] - a “single-use key” - a secure token that identifies a member for email purposes (such as found in membership-related emails that we send to members).

Response Messages

403 Forbidden - if suk is missing or invalid and the member is not already authenticated, or the member is authenticated and the suk identifies a different member, or the identified member is suspended or has deleted their profile.

{ "fail" : "Invalid Argument" }

200 OK - success

The result contains two fields:

  • code - a very short-lived security code that should be POSTed to the Authorization Server.
  • type - a string indicating what type of suk was used to get this code: will be "email", "push", or "admin" (these are the only three possibilities so far).
{ "code" : "...",
  "type" : "email" } // or "push" or "admin"

/members/self/email/notifications [POST]

Allows a member to update their email subscription settings - protected.

Parameters

  • message (string) [optional] - if present, change whether you receive an email when a new message arrives,
  • like (string) [optional] - if present, change whether you receive an email when someone likes you,
  • view (string) [optional] - if present, change whether you receive an email when someone views your profile,
  • promo (boolean) [optional] - if present, change whether or not you want to receive promotional emails,
  • matches (boolean) [optional] - if present, change whether or not you want to receive periodic “new matches” emails,
  • new_faces (string) [optional] - if present, change whether or not you want to receive periodic “new faces” emails,
  • connection_photo (string) [optional] - if present, change whether or not you want to receive “connection photos” emails,
  • message_push (string) [optional] - if present, change whether or not you want to receive web push notifications for new messages,
  • like_push (string) [optional] - if present, change whether or not you want to receive web push notifications for new likes,
  • connection_push (string) [optional] - if present, change whether or not you want to receive web push notifications for new connections,
  • view_push (string) [optional] - if present change whether or not you want to receive web push notifications for new views of your profile.

The value of a settings has the following meaning:

  • "i" - receive the email immediately the event occurs,
  • "d" - receive summary emails once a day (some are 24h, some are 12h),
  • "n" - receive no notification,
  • "s" - receive smart notifications (likes, views, and web push).
{ "message" : "i", // or "d" or "n"
  "like" : "i", // or "d" or "n" or "s"
  "view" : "i", // or "d" or "n" or "s"
  "promo" : true, // or false
  "matches" : true, // or false
  "new_faces" : "i", // or "n"
  "connection_photo" : "i", // or "n"
  "message_push" : "s", // or "n"
  "like_push" : "s", // or "n"
  "connection_push" : "s", // or "n"
  "view_push" : "s" // or "n"
}

Response Message

403 Forbidden

If any of the settings have an illegal value.

{ "fail" : "Invalid Argument" }

200 OK - success

The updated settings, as if GET /members/self/email/notifications was called.

{ "message" : "i", // or "d" or "n"
  "like" : "i", // or "d" or "n" or "s"
  "view" : "i", // or "d" or "n" or "s"
  "promo" : true, // or false
  "matches" : true // or false
}

/members/self/email/password-reset [POST]

Send a password reset link (via email) - protected.

Parameters

none.

Response Message

200 OK - success

{ }

/members/self/email/track [POST]

Given an email tracking ID, record that the email link was clicked - unprotected.

Parameters

  • tid (string) [REQUIRED] - a “tracking ID” - a unique token that identifies an email in our system.

Response Message

403 Forbidden - if tid is missing.

{ "fail" : "Invalid Argument" }

200 OK - success

{ }

/members/self/email/unsubscribe [POST]

Unsubscribe the member from all email notifications - unprotected.

Parameters

  • suk (string) [REQUIRED] - a “single-use key” - a secure token that identifies a member for email purposes (such as found in membership-related emails that we send to members).

Response Message

403 Forbidden - if suk is missing or invalid and the member is not already authenticated, or the member is authenticated and the suk identifies a different member.

{ "fail" : "Invalid Argument" }

200 OK - success

{ }

/members/self/email/validate [POST]

Validate the member’s email address - unprotected.

Parameters

  • suk (string) [REQUIRED] - a “single-use key” - a secure token that identifies a member for email purposes (such as found in registration-related emails that we send to members).

Response Message

403 Forbidden - if suk is missing or invalid and the member is not already authenticated, or the member is authenticated and the suk identifies a different member.

{ "fail" : "Invalid Argument" }

200 OK - success

{ }

/members/self/email/validations [POST]

Re-send the email confirmation link (via email) - protected.

Parameters

none.

Response Message

200 OK - success

{ }