Keystone Developers
Open Keystone
API reference

Internal API

Consumer auth

5 endpoints.

POST/api/v1/internal/consumer-auth/complete

Complete

Parameters

NameInTypeDescription
x-internal-api-keyheaderstring | null

Request bodyrequired

application/jsonCompleteBody
FieldTypeDescription
business_idrequiredstring (uuid)
phonerequiredstring
emailrequiredstring
first_namerequiredstring
last_namerequiredstring
webchat_session_idstring | null
client_user_agentstring | null
client_ipstring | null

Responses

200Successful Response
application/jsonSuccessResponse_CompleteData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredCompleteData
CompleteData fields
FieldTypeDescription
consumer_idrequiredstring (uuid)
consumerrequiredConsumerAuthProfile
ConsumerAuthProfile fields
FieldTypeDescription
idrequiredstring (uuid)
emailstring | null
phonestring | null
primary_identifierstring | null
first_namestring | null
last_namestring | null
event_idstring | null
metadataResponseMetadata | null
ResponseMetadata fields
FieldTypeDescription
paginationPaginationMetadata | null
PaginationMetadata fields
FieldTypeDescription
limitrequiredinteger
next_cursorstring | null
prev_cursorstring | null
has_morerequiredboolean
has_prevbooleandefault false
total_countinteger | null
status_countsobject | null
object | null fields

Map of string to integer

lifecycle_countsLifecycleCounts | null
LifecycleCounts fields
FieldTypeDescription
leadintegerdefault 0
prospectintegerdefault 0
customerintegerdefault 0
former_customerintegerdefault 0
classification_countsClassificationCounts | null
ClassificationCounts fields
FieldTypeDescription
signalobject
object fields

Nested object (not expanded)

touchobject
object fields

Nested object (not expanded)

stageobject
object fields

Nested object (not expanded)

metaResponseMeta | null
ResponseMeta fields
FieldTypeDescription
totalinteger | null
total_countinteger | null
pageinteger | null
per_pageinteger | null
  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/internal/consumer-auth/phone-entry

Phone Entry

Parameters

NameInTypeDescription
x-internal-api-keyheaderstring | null

Request bodyrequired

application/jsonPhoneEntryBody
FieldTypeDescription
business_idrequiredstring (uuid)
phonerequiredstring

Responses

200Successful Response
application/jsonSuccessResponse_PhoneEntryData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredPhoneEntryData
PhoneEntryData fields
FieldTypeDescription
consumer_idrequiredstring (uuid)
business_contact_idrequiredstring (uuid)
contact_was_newbooleandefault false
metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/internal/consumer-auth/prefill

Prefill

Parameters

NameInTypeDescription
business_idrequiredquerystring (uuid)
phonerequiredquerystring
x-internal-api-keyheaderstring | null

Responses

200Successful Response
application/jsonSuccessResponse_PrefillData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredPrefillData
PrefillData fields
FieldTypeDescription
first_namestring | null
last_namestring | null
emailstring | null
metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

POST/api/v1/internal/consumer-auth/resolve-api-key

Resolve Api Key

Parameters

NameInTypeDescription
x-internal-api-keyheaderstring | null

Request bodyrequired

application/jsonResolveApiKeyBody
FieldTypeDescription
api_keyrequiredstring

Responses

200Successful Response
application/jsonSuccessResponse_ResolveApiKeyData_
FieldTypeDescription
request_idrequiredstring
successtruedefault true
datarequiredResolveApiKeyData
ResolveApiKeyData fields
FieldTypeDescription
business_idrequiredstring (uuid)
metadataResponseMetadata | null
ResponseMetadata fields

ResponseMetadata, expanded above.

metaResponseMeta | null
ResponseMeta fields

ResponseMeta, expanded above.

  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.

GET/api/v1/internal/consumers/{consumer_id}/portal-profile

Consumer Portal Profile

Parameters

NameInTypeDescription
consumer_idrequiredpathstring (uuid)
business_idquerystring (uuid) | null
x-internal-api-keyheaderstring | null

Responses

200Successful Response
application/jsonany
  • 400Bad request
  • 401Unauthorized
  • 403Forbidden
  • 404Not found
  • 422Validation error
  • 500Internal server error
  • 503Service unavailable

Error bodies: ErrorResponse. See Errors.