Start SMS log export job

POST https://sms.8x8.com/api/v1/subaccounts/:subAccountId/messages/exports
  • Sending a POST request on this endpoint allows to request an SMS logs file.

URL

The 8x8 SMS subAccountId needs to be provided in the URL as shown below: https://sms.8x8.com/api/v1/subaccounts/{subAccountID}/messages/exports

You must replace {subAccountId} in the URL above with the subaccountid that you want to use.

Request

Path Parameters

    subAccountId stringrequired

    Possible values: >= 3 characters and <= 50 characters, Value must match regular expression ^[A-Za-z0-9\-._&]{3,50}$

    You must replace {subAccountId} with the subaccountid that you want to use. By default this is generated once you signed up with a new account at https://connect.8x8.com.

Body

    fromstring<date-time>

    The values can be entered either as:

    • UTC date (yyyy-MM-dd format).
    • UTC timezone datetime, then the expected format is yyyy-MM-ddTHH:mm:ssZ
    • or as local timezone datetime, then the expected format is yyyy-MM-ddTHH:mm:sszzz

    The API will automatically determine whether the datetime is UTC or local based on the format of the value.
    The default value is UTC today - 7 days.
    The value should less than value of to parameter.

    Example values:

    • 2020-07-01 Date without time
    • 2020-07-01T13:00:00 (UTC Time)
    • 2020-07-01T13:00:00+07:00 Datetime with timezone
    tostring<date-time>

    The values can be entered either as:

    • UTC date (yyyy-MM-dd format).
    • UTC timezone datetime, then the expected format is yyyy-MM-ddTHH:mm:ssZ
    • or as local timezone datetime, then the expected format is yyyy-MM-ddTHH:mm:sszzz

    The API will automatically determine whether the datetime is UTC or local based on the format of the value.
    The default value is today in UTC timezone.
    The value should less than value of to parameter.

    Example values:

    • 2020-07-01 Date without time
    • 2020-07-01T13:00:00 (UTC Time)
    • 2020-07-01T13:00:00+07:00 Datetime with timezone
    phoneNumberstring

    Valid phone number in E.164 format.

    Example: 6511111111
    countriescountry (string)[]

    The list of two-letter ISO 3166 country codes that the message has been sent to

    Possible values: >= 2 characters and <= 2 characters

    Example: ["US","SG"]
    limitinteger

    You also need to define if you would like to limit the number of records to fetch using the parameter limit and an integer value

    If you do not want to put a limit on the number of records to retrieve, setting limit to 0 allows to set is as unlimited.

    • NB: a longer time-span (eg: several months) and no limit on the records number will increase the time required to generate the logs file.

Schema

    jobIdstringrequired

    Identifier of the job started. Use this value to query job result.

{
"jobId":"string"
}
{
"jobId":"F1T6z9C5tW2QV1pdMzO9xpMXrYEmfnvqORGqpePJGpgzjTJ80TSaZEE7aX2wrgix"
}

Source: https://developer.8x8.com/connect/reference/reporting-api-2 · 8x8 CPaaS Developer Docs. Synced for support deflection.

Was this article helpful?
or
0 out of 0 found this helpful

0 Comments

Please sign in to leave a comment.

Didn't find what you were looking for?

Submit a request