Skip to main content
Version: 1.7.3

RequestByEmail

Use this endpoint to send an e-sign request to the clients via email. Once they e-sign, you’ll be notified; you can e-sign it and proceed with the filing.

POST Form8453EMP/RequestByEmail
Run in Postman

Request Body

FieldTypeDescription
RecordIdGuidA Unique Record Identifier generated by TaxBandits when a 94X return is created
TaxPayerEmailstringEmail Address of the taxpayer.
Note: Taxpayer will be requested to E-sign Form 8453-EMP through this email address
Size Range: ..100
TaxPreparerEmailstringEmail Address of the tax preparer.
Note: Signed 8453-EMP form will be sent to the tax preparer’s email after the taxpayer signs.
Size Range: ..100
CustomizationIdGuidOptional A unique customization identifier generated by TaxBandits after you complete the customization in the console.
Note: This service will be available soon.
CustomizationobjectOptional Collects the customizations like Business Logo, PrimaryColor, SecondaryColor, etc.
    BusinessLogoUrlstringOptional Business Logo that will be displayed on the Form completion page.
Size Range: ..150
    LogoPositionStringOptional Gets the position in which the logo should be displayed.
Allowed values

"LEFT", "CENTER", "RIGHT"

    PrimaryColorStringOptional Gets the primary color for the portal. You can use this to customize the color theme of the portal to match with your application color
    SecondaryColorStringOptional Gets the secondary color for the portal. You can use this to customize the color theme of the portal to match with your application color

Request Json

{
"RecordId": "0a148914-1125-4cf3-a48a-5ce8b750693e",
"TaxPayerEmail": "shawn@sample.com",
"TaxPreparerEmail": "peter@sample.com",
"CustomizationId": null,
"Customization": {
"BusinessLogoUrl": "https://www.spanenterprises.com/Content/Images/span.png",
"LogoPosition": "LEFT",
"PrimaryColor": "#20DEE5",
"SecondaryColor": "#8C1FCB"
}
}

Response Body

FieldTypeDescription
RecordIdGuidA Unique Record Identifier generated by TaxBandits when a 94X return is created
RecordStatusStringStatus of Form 8453-EMP
StatusMessageStringShows detailed Status message of Form 8453-EMP
Errorsobject[]Detailed error information.
    IdstringError ID number. This ID is assigned by TaxBandits and it is unique for each error.
    NamestringName of the errored node.
    MessagestringShows the error message.

Response Json

{
"RecordId": "0a148914-1125-4cf3-a48a-5ce8b750693e",
"RecordStatus": "E-Sign Requested",
"StatusMessage": "Sign Requested to the Payer",
"Errors": null
}