Skip to content

Record volunteer check-in or check-out punch

POST
/api/integrations/clock/punch
curl --request POST \
--url https://example.com/api/integrations/clock/punch \
--header 'Content-Type: application/json' \
--header 'x-kiosk-secret: <x-kiosk-secret>' \
--data '{ "phone": "+17045551234", "action": "auto" }'
Media typeapplication/json
object
phone
required
string
Example
+17045551234
action
string
default: auto
Allowed values: auto in out
Example
auto

Punch recorded successfully

Media typeapplication/json
object
status
required
string
Allowed values: clocked_in clocked_out
volunteer_name
required
string
clock_in
required
string format: date-time
clock_out
string format: date-time
nullable
Example
{
"status": "clocked_in",
"volunteer_name": "Jane D."
}

Bad request / Invalid input parameters

Media typeapplication/problem+json

RFC 7807 Problem Details for HTTP APIs

object
type
required
string
title
required
string
status
required

Current status of the record or process.

integer
detail
required
string
instance
string
retry_after
integer
Example
{
"status": "IN_PROGRESS",
"retry_after": 60
}

Authentication required or invalid credentials

Media typeapplication/problem+json

RFC 7807 Problem Details for HTTP APIs

object
type
required
string
title
required
string
status
required

Current status of the record or process.

integer
detail
required
string
instance
string
retry_after
integer
Example
{
"status": "IN_PROGRESS",
"retry_after": 60
}

Resource not found

Media typeapplication/problem+json

RFC 7807 Problem Details for HTTP APIs

object
type
required
string
title
required
string
status
required

Current status of the record or process.

integer
detail
required
string
instance
string
retry_after
integer
Example
{
"status": "IN_PROGRESS",
"retry_after": 60
}

Resource state conflict

Media typeapplication/problem+json

RFC 7807 Problem Details for HTTP APIs

object
type
required
string
title
required
string
status
required

Current status of the record or process.

integer
detail
required
string
instance
string
retry_after
integer
Example
{
"status": "IN_PROGRESS",
"retry_after": 60
}