RequestByUrlPreparer

Use this endpoint to obtain a secure URL that can be embedded in your software or portal. You or your team members (who are authorized to sign the return) can e-sign the 8453-EMP form upon clicking the URL.

POST Form8453emp/RequestByURLPreparer 

Request Body

Field	Type	Description
RecordId	Guid	A Unique Record Identifier generated by TaxBandits when a 94X return is created.
customizationId	Guid	Optional A unique customization identifier generated by TaxBandits after you complete the customization in the console. Note: This service will be available soon.
Customization	object	Optional Collects the customizations like Business Logo, PrimaryColor, SecondaryColor, etc.
BusinessLogoUrl	String	Optional Gets the Business Logo. If given the business logo will be shown in the Iframe page. Size Range: ..150
LogoPosition	String	Optional Gets the position in which the logo should be displayed. Allowed values "LEFT", "CENTER", "RIGHT"
PrimaryColor	String	Optional 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
SecondaryColor	String	Optional 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
RedirectUrls	object	Optional Collects the Redirect Urls as ReturnUrl and CancelUrl
ReturnUrl	String	Optional Return Redirection URL. Set the callback URL redirection once the tax preparer completes Form 8453-EMP Size Range: ..150
CancelUrl	String	Optional Cancel Redirection URL. Set the callback URL when the tax preparer clicks the cancel button on the Form 8453-EMP. Note: If you do not provide the Cancel Callback Redirection URL, the cancel button will not be shown to the tax preparer. Size Range: ..150

Request Json

{
 "RecordId": "d3643ae5-a55a-40aa-ab78-3b2f9ca7b7bb",
 "CustomizationId": null,
 "Customization": {
       "BusinessLogoUrl": "https://www.spanenterprises.com/Content/Images/span.png",
       "LogoPosition": "CENTER",
       "PrimaryColor": "#E61A1A",
       "SecondaryColor": "#18F244"
   },
 "RedirectUrls": {
       "ReturnUrl": "https://example1.com",
       "CancelUrl": "https://example2.com"
   }
}

Response Body

Field	Type	Description
RecordId	Guid	A Unique Record Identifier generated by TaxBandits when a 94X return is created.
Form8453EMPUrlPayer	String	URL that can be accessed on its own or embedded on the client's website using Iframe or other means.
Errors	object[]	Detailed error information.
Id	String	Error ID number. This ID is assigned by TaxBandits and it is unique for each error.
Name	String	Name of the errored node.
Message	String	Shows the error message.

Response JSON

{
    "RecordId": "d3643ae5-a55a-40aa-ab78-3b2f9ca7b7bb",
    "Form8453EMPUrlPreparer": "https://tbs-links.stsstage.com/Form8453EMP/Form8453?tpatkn=899a317a-0982-42eb-98d9-16cb07189ad9&tprptkn=0b5bf3cd-f45f-4b97-b50d-fee1aaf50ce4",
    "Errors": null
}