action britbox_register { label: "register" description: "Register a new user, creating them an account.\n\nRegistration, when successful, will return an array of access tokens so the user is\nimmediately signed in.\n\nIt returns Catalog and Commerce scoped tokens for both Account and Profile.\nThe Commerce ones are intended to allow the purchase of a subscription plan\nin the step after registration, without the user being prompted to enter\ntheir username and password again.\n\nAn email will also be sent with a link they need to click to confirm their\nemail address. This confirmation is done via the /verify-email endpoint.\n" provider: britbox method: POST path: "/register" encoding: json input: { type: "object" required: ["email", "password"] properties: { email: { type: "string" } firstName: { type: "string" } languageCode: { type: "string" description: "The code of the preferred language for the primary profile.\nMust be a valid ISO language code e.g. \"en-US\" and must match the code of\none of the languages specified in the app config.\nSee https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\n" } lastName: { type: "string" } marketing: { type: "boolean" description: "Whether to receive marketing material or not. Default to true." } password: { type: "string" } pin: { type: "string" description: "The primary account pin." } segments: { type: "array" description: "The segments to apply to the primary profile." items: { type: "string" } } } additionalProperties: false } output: { type: "array" items: { type: "object" required: ["value", "refreshable", "expirationDate", "type"] properties: { accountCreated: { type: "boolean" description: "When a `UserAccount` token is issued during a single-sign-on flow\na user may have been automatically registered if they didn't\nhave an account already. If this occurs then `accountCreated`\nwill be `true`.\n" } expirationDate: { type: "string" format: "date-time" description: "The timestamp this token expires." } refreshable: { type: "boolean" description: "True if this token can be refreshed, false if not." } type: { type: "string" description: "The type of the token." enum: ["UserAccount", "UserProfile"] } value: { type: "string" description: "The token value used for authenticated requests." } } additionalProperties: false } additionalProperties: false } }