Answer the website’s form

Submit the account holder’s answers to the current website sign-in form.

POST/v1/connections/attempts/{attempt_id}/submit

Sends the person’s answers to the current form: fields by field id, or choice for an alternative. Answers with the attempt once the website responded (wait) or as it stands.

Requires Authorization: Bearer $FOUS_API_KEY. Create a key.

Path parameters

attempt_idstringrequired

Query parameters

waitintegerdefault 0

Request body

Required. JSON.

challenge_idstringrequired
step_idstringrequired
fieldsobject
choicestring

Response 200

Success

successtruerequired
dataConnectionAttemptrequired
One sign-in, step by step. challenge: the website asks for something, described in form; submit the answers. working: wait. verified: confirm it. ready: the account is connected. failed: notice says why, can_retry whether another method can be tried.

Errors

Every failure is an Error: branch on error.code. The errors guide lists each code.

400
401WWW-Authenticate
402
403
404
408
409
410
413
422
429Retry-After
500
502
503Retry-After
504

POST/v1/connections/attempts/{attempt_id}/submit
Terminal
$curl 'https://api.fous.com/v1/connections/attempts/{attempt_id}/submit?wait=60' \
>  -H "Authorization: Bearer $FOUS_API_KEY" \
>  -H 'Content-Type: application/json' \
>  -d '{"challenge_id":"11111111-1111-4111-8111-111111111111","step_id":"22222222-2222-4222-8222-222222222222","fields":{"email":"you@example.com","password":"your-password"}}'